misc/parsarg.h

   1 /*
   2 THE COMPUTER CODE CONTAINED HEREIN IS THE SOLE PROPERTY OF PARALLAX
   3 SOFTWARE CORPORATION ("PARALLAX").  PARALLAX, IN DISTRIBUTING THE CODE TO
   4 END-USERS, AND SUBJECT TO ALL OF THE TERMS AND CONDITIONS HEREIN, GRANTS A
   5 ROYALTY-FREE, PERPETUAL LICENSE TO SUCH END-USERS FOR USE BY SUCH END-USERS
   6 IN USING, DISPLAYING,  AND CREATING DERIVATIVE WORKS THEREOF, SO LONG AS
   7 SUCH USE, DISPLAY OR CREATION IS FOR NON-COMMERCIAL, ROYALTY OR REVENUE
   8 FREE PURPOSES.  IN NO EVENT SHALL THE END-USER USE THE COMPUTER CODE
   9 CONTAINED HEREIN FOR REVENUE-BEARING PURPOSES.  THE END-USER UNDERSTANDS
  10 AND AGREES TO THE TERMS HEREIN AND ACCEPTS THE SAME BY USE OF THIS FILE.
  11 COPYRIGHT 1993-1999 PARALLAX SOFTWARE CORPORATION.  ALL RIGHTS RESERVED.
  12 */
  13
  14
  15 /*
  16
  17         Routine to parse the command line. Will also read and parse args
  18         from a file.
  19
  20         parse_args() is called with argc & argv from main(), the function
  21         to be called with each argument, and flags.  argc & argv are usually
  22         adjusted to not pass the first parameter (the program file name).
  23         Thus the general method of calling is:
  24
  25                 parse_args(argc-1,argv+1,hander_func,flags);
  26
  27         handler_func() is then called with each parameter.
  28
  29         If the PA_EXPAND flag is passed, all arguments which do not start
  30         with '-' are assumed to be filenames and are expanded for wildcards,
  31         with the handler function called for each match.  If a spec matches
  32         nothing, the spec itself is passed to the handler func.
  33
  34         Args that start with '@' are assumed to be argument files.  These
  35         files are opened, and arguments are read from them just as if they
  36         were specified on the command line.  Arg files can be nested.
  37
  38 */
  39
  40 //Flags
  41
  42 #define PA_EXPAND       1       //wildcard expand args that don't start with '-'
  43
  44
  45 //Function
  46
  47 void parse_args(int argc,char **argv,void (*handler_func)(char *arg),int flags);
  48