CharNextExA function (winuser.h)
Retrieves the pointer to the next character in a string. This function can handle strings consisting of either single- or multi-byte characters.
Syntax
LPSTR CharNextExA(
[in] WORD CodePage,
[in] LPCSTR lpCurrentChar,
[in] DWORD dwFlags
);
Parameters
[in] CodePage
Type: WORD
The identifier of the code page to use to check lead-byte ranges. Can be one of the code-page values provided in Code Page Identifiers, or one of the following predefined values.
| Value | Meaning |
|---|---|
|
Use system default ANSI code page. |
|
Use the system default Macintosh code page. |
|
Use system default OEM code page. |
[in] lpCurrentChar
Type: LPCSTR
A character in a null-terminated string.
[in] dwFlags
Type: DWORD
This parameter is reserved and must be 0.
Return value
Type: LPSTR
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.
Remarks
CharNextExA specifies a code-page to use, whereas CharNext (if called as an ANSI function) uses the system default code-page.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winuser.h (include Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |
See also
Conceptual
Reference