["Little Useful Bits" Library]

This utility provides a simple means of manipulating a vector of command textual words. More...


typedef lub_argv_s lub_argv_t


unsigned lub_argv_wordcount (const char *line)
lub_argv_tlub_argv_new (const char *line, size_t offset)
void lub_argv_delete (lub_argv_t *instance)
unsigned lub_argv__get_count (const lub_argv_t *instance)
const char * lub_argv__get_arg (const lub_argv_t *instance, unsigned index)
size_t lub_argv__get_offset (const lub_argv_t *instance, unsigned index)
bool_t lub_argv__get_quoted (const lub_argv_t *instance, unsigned index)
void lub_argv__set_arg (lub_argv_t *instance, unsigned index, const char *arg)

Detailed Description

This utility provides a simple means of manipulating a vector of command textual words.

A word is either separated by whitespace, or if quotes are used a word is defined by the scope of the quotes.


one two "this is the third word" four
contains four "words" the third of which is a string.

Typedef Documentation

typedef struct lub_argv_s lub_argv_t

This type is used to reference an instance of an argument vector

Function Documentation

lub_argv_t* lub_argv_new ( const char *  line,
size_t  offset 

This operation is used to construct an instance of this class. The client species a string and an offset within that string, from which to start collecting "words" to place into the vector instance.

  • none
  • A instance of an argument vector, which represents the words contained in the provided string.
  • NULL if there is insuffcient resource
  • The client becomes resposible for releasing the instance when they are finished with it, by calling lub_argv_delete()
line  The string to analyse
offset  The offset in the string to start from

unsigned lub_argv_wordcount ( const char *  line  ) 

  • none
The number of space separated words in the specified string.
  • none
line  The string to analyse

Generated on Tue Apr 29 13:41:08 2008 for CLISH by  doxygen 1.5.1