awParseStringFromString

BrokerError awParseStringFromString(
char *start,
char **next,
int do_copy,
char **output);

start	The string to be parsed.
next	The character immediately following the character that caused parsing to terminate. This parameter is used for output.
do_copy	Indicates whether or not memory should be allocated for the extracted string. If set to 1 (true) , memory will be allocated.
output	The extracted value. This parameter is used for output.

Extracts a string from the source string specified by start. Parsing will proceed until a null or newline character is encountered. The character immediately following the one that caused parsing to end is provided in next. You may set next to NULL if you do not need to know about this character.

Possible BrokerError major codes	Meaning
AW_ERROR_NULL_PARAM	The parameter output or start are NULL.

Important:
This function will alter the contents of the string being parsed.