SYNOPSIS

int MGOparse (char *string, int *position, char *token, int size, int opt)

DESCRIPTION

The MGOparse() function parses a string of key-value pairs and copies the first one relative to position into token. size is the maximum number of characters to copy into token. position is updated to the start of the next key-value. Thus, each call to MGOparse() returns the next key-value from the string. opt controls how the token is post-processed. It can be one or more of:

RETURN VALUE

Returns the number of characters in token if one is present, 0 if no more key-value pairs are present or -1 if the result is larger than size.

SEE ALSO

MGOkeyname(), MGOlocase(), MGOupcase(), MGOvalue()