1 /* 2 * Copyright 2008-2009 Katholieke Universiteit Leuven 3 * 4 * Use of this software is governed by the MIT license 5 * 6 * Written by Sven Verdoolaege, K.U.Leuven, Departement 7 * Computerwetenschappen, Celestijnenlaan 200A, B-3001 Leuven, Belgium 8 */ 9 10 #ifndef ISL_ARG_H 11 #define ISL_ARG_H 12 13 #include <stddef.h> 14 #include <stdlib.h> 15 16 #if defined(__cplusplus) 17 extern "C" { 18 #endif 19 20 struct isl_arg_choice { 21 const char *name; 22 unsigned value; 23 }; 24 25 struct isl_arg_flags { 26 const char *name; 27 unsigned mask; 28 unsigned value; 29 }; 30 31 enum isl_arg_type { 32 isl_arg_end, 33 isl_arg_alias, 34 isl_arg_arg, 35 isl_arg_bool, 36 isl_arg_child, 37 isl_arg_choice, 38 isl_arg_flags, 39 isl_arg_footer, 40 isl_arg_int, 41 isl_arg_user, 42 isl_arg_long, 43 isl_arg_ulong, 44 isl_arg_str, 45 isl_arg_str_list, 46 isl_arg_version 47 }; 48 49 struct isl_args; 50 51 struct isl_arg { 52 enum isl_arg_type type; 53 char short_name; 54 const char *long_name; 55 const char *argument_name; 56 #define ISL_ARG_OFFSET_NONE ((size_t) -1) 57 size_t offset; 58 const char *help_msg; 59 #define ISL_ARG_SINGLE_DASH (1 << 0) 60 #define ISL_ARG_BOOL_ARG (1 << 1) 61 #define ISL_ARG_HIDDEN (1 << 2) 62 unsigned flags; 63 union { 64 struct { 65 struct isl_arg_choice *choice; 66 unsigned default_value; 67 unsigned default_selected; 68 int (*set)(void *opt, unsigned val); 69 } choice; 70 struct { 71 struct isl_arg_flags *flags; 72 unsigned default_value; 73 } flags; 74 struct { 75 unsigned default_value; 76 int (*set)(void *opt, unsigned val); 77 } b; 78 struct { 79 int default_value; 80 } i; 81 struct { 82 long default_value; 83 long default_selected; 84 int (*set)(void *opt, long val); 85 } l; 86 struct { 87 unsigned long default_value; 88 } ul; 89 struct { 90 const char *default_value; 91 } str; 92 struct { 93 size_t offset_n; 94 } str_list; 95 struct { 96 struct isl_args *child; 97 } child; 98 struct { 99 void (*print_version)(void); 100 } version; 101 struct { 102 int (*init)(void*); 103 void (*clear)(void*); 104 } user; 105 } u; 106 }; 107 108 struct isl_args { 109 size_t options_size; 110 struct isl_arg *args; 111 }; 112 113 #define ISL_ARGS_START(s,name) \ 114 struct isl_arg name ## LIST[]; \ 115 struct isl_args name = { sizeof(s), name ## LIST }; \ 116 struct isl_arg name ## LIST[] = { 117 #define ISL_ARGS_END \ 118 { isl_arg_end } }; 119 120 #define ISL_ARG_ALIAS(l) { \ 121 .type = isl_arg_alias, \ 122 .long_name = l, \ 123 }, 124 #define ISL_ARG_ARG(st,f,a,d) { \ 125 .type = isl_arg_arg, \ 126 .argument_name = a, \ 127 .offset = offsetof(st, f), \ 128 .u = { .str = { .default_value = d } } \ 129 }, 130 #define ISL_ARG_FOOTER(h) { \ 131 .type = isl_arg_footer, \ 132 .help_msg = h, \ 133 }, 134 #define ISL_ARG_CHOICE(st,f,s,l,c,d,h) { \ 135 .type = isl_arg_choice, \ 136 .short_name = s, \ 137 .long_name = l, \ 138 .offset = offsetof(st, f), \ 139 .help_msg = h, \ 140 .u = { .choice = { .choice = c, .default_value = d, \ 141 .default_selected = d, .set = NULL } } \ 142 }, 143 #define ISL_ARG_OPT_CHOICE(st,f,s,l,c,d,ds,h) { \ 144 .type = isl_arg_choice, \ 145 .short_name = s, \ 146 .long_name = l, \ 147 .offset = offsetof(st, f), \ 148 .help_msg = h, \ 149 .u = { .choice = { .choice = c, .default_value = d, \ 150 .default_selected = ds, .set = NULL } } \ 151 }, 152 #define ISL_ARG_PHANTOM_USER_CHOICE_F(s,l,c,setter,d,h,fl) { \ 153 .type = isl_arg_choice, \ 154 .short_name = s, \ 155 .long_name = l, \ 156 .offset = ISL_ARG_OFFSET_NONE, \ 157 .help_msg = h, \ 158 .flags = fl, \ 159 .u = { .choice = { .choice = c, .default_value = d, \ 160 .default_selected = d, .set = setter } } \ 161 }, 162 #define ISL_ARG_USER_OPT_CHOICE(st,f,s,l,c,setter,d,ds,h) { \ 163 .type = isl_arg_choice, \ 164 .short_name = s, \ 165 .long_name = l, \ 166 .offset = offsetof(st, f), \ 167 .help_msg = h, \ 168 .u = { .choice = { .choice = c, .default_value = d, \ 169 .default_selected = ds, .set = setter } } \ 170 }, 171 #define _ISL_ARG_BOOL_F(o,s,l,setter,d,h,fl) { \ 172 .type = isl_arg_bool, \ 173 .short_name = s, \ 174 .long_name = l, \ 175 .offset = o, \ 176 .help_msg = h, \ 177 .flags = fl, \ 178 .u = { .b = { .default_value = d, .set = setter } } \ 179 }, 180 #define ISL_ARG_BOOL_F(st,f,s,l,d,h,fl) \ 181 _ISL_ARG_BOOL_F(offsetof(st, f),s,l,NULL,d,h,fl) 182 #define ISL_ARG_BOOL(st,f,s,l,d,h) \ 183 ISL_ARG_BOOL_F(st,f,s,l,d,h,0) 184 #define ISL_ARG_PHANTOM_BOOL_F(s,l,setter,h,fl) \ 185 _ISL_ARG_BOOL_F(ISL_ARG_OFFSET_NONE,s,l,setter,0,h,fl) 186 #define ISL_ARG_PHANTOM_BOOL(s,l,setter,h) \ 187 ISL_ARG_PHANTOM_BOOL_F(s,l,setter,h,0) 188 #define ISL_ARG_INT_F(st,f,s,l,a,d,h,fl) { \ 189 .type = isl_arg_int, \ 190 .short_name = s, \ 191 .long_name = l, \ 192 .argument_name = a, \ 193 .offset = offsetof(st, f), \ 194 .help_msg = h, \ 195 .flags = fl, \ 196 .u = { .i = { .default_value = d } } \ 197 }, 198 #define ISL_ARG_INT(st,f,s,l,a,d,h) \ 199 ISL_ARG_INT_F(st,f,s,l,a,d,h,0) 200 #define ISL_ARG_LONG(st,f,s,lo,d,h) { \ 201 .type = isl_arg_long, \ 202 .short_name = s, \ 203 .long_name = lo, \ 204 .offset = offsetof(st, f), \ 205 .help_msg = h, \ 206 .u = { .l = { .default_value = d, .default_selected = d, \ 207 .set = NULL } } \ 208 }, 209 #define ISL_ARG_USER_LONG(st,f,s,lo,setter,d,h) { \ 210 .type = isl_arg_long, \ 211 .short_name = s, \ 212 .long_name = lo, \ 213 .offset = offsetof(st, f), \ 214 .help_msg = h, \ 215 .u = { .l = { .default_value = d, .default_selected = d, \ 216 .set = setter } } \ 217 }, 218 #define ISL_ARG_OPT_LONG(st,f,s,lo,d,ds,h) { \ 219 .type = isl_arg_long, \ 220 .short_name = s, \ 221 .long_name = lo, \ 222 .offset = offsetof(st, f), \ 223 .help_msg = h, \ 224 .u = { .l = { .default_value = d, .default_selected = ds, \ 225 .set = NULL } } \ 226 }, 227 #define ISL_ARG_ULONG(st,f,s,l,d,h) { \ 228 .type = isl_arg_ulong, \ 229 .short_name = s, \ 230 .long_name = l, \ 231 .offset = offsetof(st, f), \ 232 .help_msg = h, \ 233 .u = { .ul = { .default_value = d } } \ 234 }, 235 #define ISL_ARG_STR_F(st,f,s,l,a,d,h,fl) { \ 236 .type = isl_arg_str, \ 237 .short_name = s, \ 238 .long_name = l, \ 239 .argument_name = a, \ 240 .offset = offsetof(st, f), \ 241 .help_msg = h, \ 242 .flags = fl, \ 243 .u = { .str = { .default_value = d } } \ 244 }, 245 #define ISL_ARG_STR(st,f,s,l,a,d,h) \ 246 ISL_ARG_STR_F(st,f,s,l,a,d,h,0) 247 #define ISL_ARG_STR_LIST(st,f_n,f_l,s,l,a,h) { \ 248 .type = isl_arg_str_list, \ 249 .short_name = s, \ 250 .long_name = l, \ 251 .argument_name = a, \ 252 .offset = offsetof(st, f_l), \ 253 .help_msg = h, \ 254 .u = { .str_list = { .offset_n = offsetof(st, f_n) } } \ 255 }, 256 #define _ISL_ARG_CHILD(o,l,c,h,fl) { \ 257 .type = isl_arg_child, \ 258 .long_name = l, \ 259 .offset = o, \ 260 .help_msg = h, \ 261 .flags = fl, \ 262 .u = { .child = { .child = c } } \ 263 }, 264 #define ISL_ARG_CHILD(st,f,l,c,h) \ 265 _ISL_ARG_CHILD(offsetof(st, f),l,c,h,0) 266 #define ISL_ARG_GROUP_F(l,c,h,fl) \ 267 _ISL_ARG_CHILD(ISL_ARG_OFFSET_NONE,l,c,h,fl) 268 #define ISL_ARG_GROUP(l,c,h) \ 269 ISL_ARG_GROUP_F(l,c,h,0) 270 #define ISL_ARG_FLAGS(st,f,s,l,c,d,h) { \ 271 .type = isl_arg_flags, \ 272 .short_name = s, \ 273 .long_name = l, \ 274 .offset = offsetof(st, f), \ 275 .help_msg = h, \ 276 .u = { .flags = { .flags = c, .default_value = d } } \ 277 }, 278 #define ISL_ARG_USER(st,f,i,c) { \ 279 .type = isl_arg_user, \ 280 .offset = offsetof(st, f), \ 281 .u = { .user = { .init = i, .clear = c} } \ 282 }, 283 #define ISL_ARG_VERSION(print) { \ 284 .type = isl_arg_version, \ 285 .u = { .version = { .print_version = print } } \ 286 }, 287 288 #define ISL_ARG_ALL (1 << 0) 289 #define ISL_ARG_SKIP_HELP (1 << 1) 290 291 void isl_args_set_defaults(struct isl_args *args, void *opt); 292 void isl_args_free(struct isl_args *args, void *opt); 293 int isl_args_parse(struct isl_args *args, int argc, char **argv, void *opt, 294 unsigned flags); 295 296 #define ISL_ARG_DECL(prefix,st,args) \ 297 extern struct isl_args args; \ 298 st *prefix ## _new_with_defaults(void); \ 299 void prefix ## _free(st *opt); \ 300 int prefix ## _parse(st *opt, int argc, char **argv, unsigned flags); 301 302 #define ISL_ARG_DEF(prefix,st,args) \ 303 st *prefix ## _new_with_defaults() \ 304 { \ 305 st *opt = (st *)calloc(1, sizeof(st)); \ 306 if (opt) \ 307 isl_args_set_defaults(&(args), opt); \ 308 return opt; \ 309 } \ 310 \ 311 void prefix ## _free(st *opt) \ 312 { \ 313 isl_args_free(&(args), opt); \ 314 } \ 315 \ 316 int prefix ## _parse(st *opt, int argc, char **argv, unsigned flags) \ 317 { \ 318 return isl_args_parse(&(args), argc, argv, opt, flags); \ 319 } 320 321 #if defined(__cplusplus) 322 } 323 #endif 324 325 #endif 326
Indexes created Fri Jun 19 00:25:02 UTC 2026