Export (0) Print
Expand All

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.

ValueMeaning
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

Unicode and ANSI names

CharNextExA (ANSI)

See also

Reference
CharNext
CharPrevExA
Conceptual
Strings

 

 

Community Additions

ADD
Show:
© 2014 Microsoft