CharNextExA

[Now Supported on Windows NT]

The CharNextExA function retrieves the pointer to the next character in a string. This function can handle strings consisting of either single- or multi-byte characters.

LPSTR CharNextExA(

WORD CodePage, // identifier of the code page
LPCSTR lpCurrentChar, // pointer to current character
DWORD dwFlags // reserved; must be zero
);  

Parameters

CodePage

Identifier of the code page to use to check lead-byte ranges. Can be one of the code-page values provided in the "Code-Page Identifiers" table in Unicode and Character Set Constants or one of the following predefined values:

Value Meaning
0 Use system default ANSI code page.
CP_ACP Use system default ANSI code page.
CP_OEMCP Use system default OEM code page.

lpCurrentChar

Pointer to a character in a null-terminated string.

dwFlags

Reserved; must be zero.

Return Values

If the function succeeds, the return value is a pointer to the next character in the string, or to the terminating null character if at the end of the string.

If lpCurrentChar points to the terminating null character, the return value is equal to lpCurrentChar.

See Also

CharNext, CharPrevExA