Text::FindUnquotedChar

Defined in: C4String.h

Searches for a particular byte value in a string.

Prototype

int32 FindUnquotedChar(const char *text, unsigned_int32 k);

Parameters

`text`	A pointer to a null-terminated character string.
`k`	An 8-bit bytes value to search for.

Description

The FindUnquotedChar function searches the string specified by the text parameter for the byte value given by the k parameter. Any text enclosed in double quotes (ASCII character 34) is ignored during the search. The quotes themselves are also ignored, so it is not possible to search for a quote character using this function.

If the character given by k is found outside of double quotes, the the byte position within the string of the first occurrence is returned. If it is not found, then the return value is −1.