argv
["Little Useful Bits" Library]

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

Typedefs
typedef lub_argv_s	lub_argv_t
Functions
unsigned	lub_argv_wordcount (const char *line)
lub_argv_t *	lub_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.

e.g.

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. Precondition: none Returns: A instance of an argument vector, which represents the words contained in the provided string. NULL if there is insuffcient resource Postcondition: The client becomes resposible for releasing the instance when they are finished with it, by calling lub_argv_delete() Parameters: line  The string to analyse offset  The offset in the string to start from

unsigned lub_argv_wordcount (  const char *  line  )

Precondition: none Returns: The number of space separated words in the specified string. Postcondition: none Parameters: line  The string to analyse

---