home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / EFFO / forum7.lzh / RICO / MAN / man.makeargv < prev    next >
Text File  |  1988-09-26  |  999b  |  43 lines

  1.  
  2. makeargv - build an argv-style array from a string
  3.  
  4. SYNOPSIS
  5.  
  6.      int makeargv(str, argvp)
  7.      char *str;
  8.      char ***argvp;
  9.  
  10. DESCRIPTION
  11.  
  12.     makeargv breaks up an ordinary string into a count and array like
  13.     those passed to main() as argc & argv.
  14.     Argv is MALLOC'd in makeargv; to free it, call FREE(argv).
  15.  
  16.     The first arg is placed in argv[0].
  17.     The original string is peppered with null chars to mark the ends of
  18.     the args, and argv[i] is filled with pointers into the original string.
  19.     An extra entry of NULL is included in argv, at argv[argc], for routines 
  20.     that use a final NULL for loop termination.
  21.  
  22. EXAMPLE
  23.  
  24.     #include <argproc.h>
  25.     char **argv;
  26.     int argc;
  27.     char cmdline[256], arg[256];
  28.     boolean xflag;
  29.  
  30.     gets(cmdline);
  31.     argc = makeargv(cmdline, &argv);
  32.     argproc(argc+1, argv-1, "%s =x", arg, &xflag);
  33.  
  34. BUGS
  35.  
  36.     Perhaps this should set argv[0] to the empty string
  37.     to be more compatible with the real argv[].
  38.  
  39. LIBRARY
  40.  
  41.     Use argproc.l
  42.  
  43.