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.

Syntax

LPSTR WINAPI CharNextExA(
  _In_ WORD   CodePage,
  _In_ LPCSTR lpCurrentChar,
  _In_ DWORD  dwFlags
);

Parameters

CodePage [in]

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
CP_ACP 0	Use system default ANSI code page.
CP_MACCP 2	Use the system default Macintosh code page.
CP_OEMCP 1	Use system default OEM code page.

 

lpCurrentChar [in]

Type: LPCSTR

A character in a null-terminated string.

dwFlags [in]

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

See also

Reference

CharNext

CharPrevExA

Conceptual

Strings