Argument Manipulation API.  
More...
|  | 
| void | argvPrint (const char *msg, ARGV_const_t argv, FILE *fp) | 
|  | 
| ARGI_t | argiFree (ARGI_t argi) | 
|  | 
| ARGV_t | argvNew (void) | 
|  | 
| ARGV_t | argvFree (ARGV_t argv) | 
|  | 
| int | argiCount (ARGI_const_t argi) | 
|  | 
| ARGint_t | argiData (ARGI_const_t argi) | 
|  | 
| int | argvCount (ARGV_const_t argv) | 
|  | 
| ARGV_t | argvData (ARGV_t argv) | 
|  | 
| int | argvCmp (const void *a, const void *b) | 
|  | 
| int | argvSort (ARGV_t argv, int(*compar)(const void *, const void *)) | 
|  | 
| ARGV_t | argvSearch (ARGV_const_t argv, const char *val, int(*compar)(const void *, const void *)) | 
|  | 
| int | argiAdd (ARGI_t *argip, int ix, int val) | 
|  | 
| int | argvAdd (ARGV_t *argvp, const char *val) | 
|  | 
| int | argvAddNum (ARGV_t *argvp, int val) | 
|  | 
| int | argvAppend (ARGV_t *argvp, ARGV_const_t av) | 
|  | 
| ARGV_t | argvSplitString (const char *str, const char *seps, argvFlags flags) | 
|  | 
| int | argvSplit (ARGV_t *argvp, const char *str, const char *seps) | 
|  | 
| char * | argvJoin (ARGV_const_t argv, const char *sep) | 
|  | 
Argument Manipulation API. 
◆ argiAdd()
      
        
          | int argiAdd | ( | ARGI_t * | argip, | 
        
          |  |  | int | ix, | 
        
          |  |  | int | val | 
        
          |  | ) |  |  | 
      
 
Add an int to an argi array. 
- Return values
- 
  
  
- Parameters
- 
  
    | ix | argi array index (or -1 to append) |  | val | int arg to add |  
 
- Returns
- 0 always 
 
 
◆ argiCount()
Return no. of elements in argi array. 
- Parameters
- 
  
  
- Returns
- no. of elements 
 
 
◆ argiData()
Return data from argi array. 
- Parameters
- 
  
  
- Returns
- argi array data address 
 
 
◆ argiFree()
Destroy an argi array. 
- Parameters
- 
  
  
- Returns
- NULL always 
 
 
◆ argvAdd()
      
        
          | int argvAdd | ( | ARGV_t * | argvp, | 
        
          |  |  | const char * | val | 
        
          |  | ) |  |  | 
      
 
Add a string to an argv array. 
- Return values
- 
  
  
- Parameters
- 
  
  
- Returns
- 0 always 
 
 
◆ argvAddNum()
      
        
          | int argvAddNum | ( | ARGV_t * | argvp, | 
        
          |  |  | int | val | 
        
          |  | ) |  |  | 
      
 
Add a number to an argv array (converting to a string). 
- Return values
- 
  
  
- Parameters
- 
  
  
- Returns
- 0 always 
 
 
◆ argvAppend()
Append one argv array to another. 
- Return values
- 
  
  
- Parameters
- 
  
  
- Returns
- 0 always 
 
 
◆ argvCmp()
      
        
          | int argvCmp | ( | const void * | a, | 
        
          |  |  | const void * | b | 
        
          |  | ) |  |  | 
      
 
Compare argv arrays (qsort/bsearch). 
- Parameters
- 
  
    | a | 1st instance address |  | b | 2nd instance address |  
 
- Returns
- result of comparison 
 
 
◆ argvCount()
Return no. of elements in argv array. 
- Parameters
- 
  
  
- Returns
- no. of elements 
 
 
◆ argvData()
Return data from argv array. 
- Parameters
- 
  
  
- Returns
- argv array data address 
 
 
◆ argvFree()
Destroy an argv array. 
- Parameters
- 
  
  
- Returns
- NULL always 
 
 
◆ argvJoin()
Join an argv array into a string. 
- Parameters
- 
  
    | *argv | argv array to join |  | sep | separator string to use |  
 
- Returns
- malloc'ed string 
 
 
◆ argvNew()
Create an empty argv array. 
- Returns
- pointer to empty argv 
 
 
◆ argvPrint()
      
        
          | void argvPrint | ( | const char * | msg, | 
        
          |  |  | ARGV_const_t | argv, | 
        
          |  |  | FILE * | fp | 
        
          |  | ) |  |  | 
      
 
Print argv array elements. 
- Parameters
- 
  
    | msg | output message prefix (or NULL) |  | argv | argv array |  | fp | output file handle (NULL uses stderr) |  
 
 
 
◆ argvSearch()
      
        
          | ARGV_t argvSearch | ( | ARGV_const_t | argv, | 
        
          |  |  | const char * | val, | 
        
          |  |  | int(*)(const void *, const void *) | compar | 
        
          |  | ) |  |  | 
      
 
Find an element in an argv array. 
- Parameters
- 
  
    | argv | argv array |  | val | string to find |  | compar | strcmp-like comparison function, or NULL for argvCmp() |  
 
- Returns
- found string (NULL on failure) 
 
 
◆ argvSort()
      
        
          | int argvSort | ( | ARGV_t | argv, | 
        
          |  |  | int(*)(const void *, const void *) | compar | 
        
          |  | ) |  |  | 
      
 
Sort an argv array. 
- Parameters
- 
  
    | argv | argv array |  | compar | strcmp-like comparison function, or NULL for argvCmp() |  
 
- Returns
- 0 always 
 
 
◆ argvSplit()
      
        
          | int argvSplit | ( | ARGV_t * | argvp, | 
        
          |  |  | const char * | str, | 
        
          |  |  | const char * | seps | 
        
          |  | ) |  |  | 
      
 
Split a string into an argv array. 
- Return values
- 
  
  
- Parameters
- 
  
    | str | string arg to split |  | seps | separator characters |  
 
- Returns
- 0 always 
 
 
◆ argvSplitString()
      
        
          | ARGV_t argvSplitString | ( | const char * | str, | 
        
          |  |  | const char * | seps, | 
        
          |  |  | argvFlags | flags | 
        
          |  | ) |  |  | 
      
 
Split a string into an argv array. 
- Parameters
- 
  
    | str | string arg to split |  | seps | separator characters |  | flags | flags to control behavior |  
 
- Returns
- argv array