CharPrevExA

[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.

See Also

CharNextExA, CharPrev