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