CharPrevExA

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
user32.lib
Header File
winuser.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

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

LPSTR CharPrevExA(

WORD CodePage,	// identifier of code page
LPCSTR lpStart,	// pointer to first character
LPCSTR lpCurrentChar,	// pointer to current character
DWORD dwFlags	// reserved; must be zero
);

Parameters
CodePage
Identifier of the code page to use to check lead-byte ranges. Can be one of the code-page values provided in the "Code-Page Identifiers" table in Unicode and Character Set Constants or one of the following predefined values:

Value	Meaning
0	Use system default ANSI code page.
CP_ACP	Use system default ANSI code page.
CP_OEMCP	Use system default OEM code page.

lpStart
Pointer to the beginning of the string.

lpCurrentChar
Pointer to a character in a null-terminated string.

dwFlags
Reserved; must be zero.

Return Values
If the function succeeds, 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.