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.

[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

See also

CharNext

CharPrevExA

Conceptual

Reference

Strings