CharPrevExA function (winuser.h)

Article
10/13/2021

Retrieves the pointer to the preceding character in a string. This function can handle strings consisting of either single- or multi-byte characters.

Syntax

LPSTR CharPrevExA(
  [in] WORD   CodePage,
  [in] LPCSTR lpStart,
  [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
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.

[in] lpStart

Type: LPCSTR

The beginning of the string.

[in] lpCurrentChar

Type: LPCSTR

A character in a null-terminated string.

[in] dwFlags

Type: DWORD

This parameter is reserved and must be zero.

Return value

Type: LPSTR

The return value is a pointer to the preceding character in the string, or to the first character in the string if the lpCurrentChar parameter equals the lpStart parameter.

Remarks

CharPrevExA specifies a code-page to use, whereas CharPrev (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]
Target Platform	Windows
Header	winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll