| 1 | // | 
|---|
| 2 | // Cforall Version 1.0.0 Copyright (C) 2022 University of Waterloo | 
|---|
| 3 | // | 
|---|
| 4 | // The contents of this file are covered under the licence agreement in the | 
|---|
| 5 | // file "LICENCE" distributed with Cforall. | 
|---|
| 6 | // | 
|---|
| 7 | // parseargs.cfa -- PUBLIC | 
|---|
| 8 | // API for arguments parsing (argc, argv) | 
|---|
| 9 | // | 
|---|
| 10 | // Author           : Thierry Delisle | 
|---|
| 11 | // Created On       : Wed Oct 12 15:28:01 2022 | 
|---|
| 12 | // Last Modified By : | 
|---|
| 13 | // Last Modified On : | 
|---|
| 14 | // Update Count     : | 
|---|
| 15 | // | 
|---|
| 16 | #pragma once | 
|---|
| 17 |  | 
|---|
| 18 | #include <array.hfa> | 
|---|
| 19 |  | 
|---|
| 20 | struct cfa_option { | 
|---|
| 21 | int val; // reserved | 
|---|
| 22 | char short_name; | 
|---|
| 23 | const char * long_name; | 
|---|
| 24 | const char * help; | 
|---|
| 25 | void * variable; | 
|---|
| 26 | bool (*parse)(const char *, void * ); | 
|---|
| 27 | }; | 
|---|
| 28 |  | 
|---|
| 29 | extern cfa_option last_option; | 
|---|
| 30 |  | 
|---|
| 31 | static inline void ?{}( cfa_option & this ) {} | 
|---|
| 32 |  | 
|---|
| 33 | forall(T & | { bool parse(const char *, T & ); }) | 
|---|
| 34 | static inline void ?{}( cfa_option & this, char short_name, const char * long_name, const char * help, T & variable ) { | 
|---|
| 35 | this.val        = 0; | 
|---|
| 36 | this.short_name = short_name; | 
|---|
| 37 | this.long_name  = long_name; | 
|---|
| 38 | this.help       = help; | 
|---|
| 39 | this.variable   = (void*)&variable; | 
|---|
| 40 | this.parse      = (bool (*)(const char *, void * ))parse; | 
|---|
| 41 | } | 
|---|
| 42 |  | 
|---|
| 43 | forall(T &) | 
|---|
| 44 | static inline void ?{}( cfa_option & this, char short_name, const char * long_name, const char * help, T & variable, bool (*parse)(const char *, T & )) { | 
|---|
| 45 | this.val        = 0; | 
|---|
| 46 | this.short_name = short_name; | 
|---|
| 47 | this.long_name  = long_name; | 
|---|
| 48 | this.help       = help; | 
|---|
| 49 | this.variable   = (void*)&variable; | 
|---|
| 50 | this.parse      = (bool (*)(const char *, void * ))parse; | 
|---|
| 51 | } | 
|---|
| 52 |  | 
|---|
| 53 | void parse_args( cfa_option options[], size_t opt_count, const char * usage, char ** & left ); | 
|---|
| 54 | void parse_args( int argc, char * argv[], cfa_option options[], size_t opt_count, const char * usage, char ** & left ); | 
|---|
| 55 |  | 
|---|
| 56 | forall( [N] ) { | 
|---|
| 57 | void parse_args( const array( cfa_option, N ) & options, const char * usage, char ** & left ); | 
|---|
| 58 | void parse_args( int argc, char * argv[], const array( cfa_option, N ) & options, const char * usage, char ** & left ); | 
|---|
| 59 | } | 
|---|
| 60 |  | 
|---|
| 61 | void print_args_usage(cfa_option options[], size_t opt_count, const char * usage, bool error)  __attribute__ ((noreturn)); | 
|---|
| 62 | void print_args_usage(int argc, char * argv[], cfa_option options[], size_t opt_count, const char * usage, bool error)  __attribute__ ((noreturn)); | 
|---|
| 63 |  | 
|---|
| 64 | forall( [N] ) { | 
|---|
| 65 | void print_args_usage( const array(cfa_option, N ) & options, const char * usage, bool error)  __attribute__ ((noreturn)); | 
|---|
| 66 | void print_args_usage(int argc, char * argv[], const array( cfa_option, N ) & options, const char * usage, bool error)  __attribute__ ((noreturn)); | 
|---|
| 67 | } | 
|---|
| 68 |  | 
|---|
| 69 | bool parse_yesno    (const char *, bool & ); | 
|---|
| 70 | bool parse_truefalse(const char *, bool & ); | 
|---|
| 71 | bool parse_settrue  (const char *, bool & ); | 
|---|
| 72 | bool parse_setfalse (const char *, bool & ); | 
|---|
| 73 |  | 
|---|
| 74 | bool parse(const char *, const char * & ); | 
|---|
| 75 | bool parse(const char *, int & ); | 
|---|
| 76 | bool parse(const char *, unsigned & ); | 
|---|
| 77 | bool parse(const char *, unsigned long & ); | 
|---|
| 78 | bool parse(const char *, unsigned long long & ); | 
|---|
| 79 | bool parse(const char *, double & ); | 
|---|