Функция CharPrevA (winuser.h)

Статья
11/20/2024

Извлекает указатель на предыдущий символ в строке. Эта функция может обрабатывать строки, состоящие из однобайтовых или многобайтовых символов.

Синтаксис

LPSTR CharPrevA(
  [in] LPCSTR lpszStart,
  [in] LPCSTR lpszCurrent
);

Параметры

[in] lpszStart

Тип: LPCTSTR

Начало строки.

[in] lpszCurrent

Тип: LPCTSTR

Символ в строке, завершаемой значением NULL.

Возвращаемое значение

Тип: LPTSTR

Возвращаемое значение — это указатель на предыдущий символ строки или на первый символ строки, если параметр lpszCurrent равен параметру lpszStart.

Замечания

При вызове функции ANSI CharPrev использует системную кодовую страницу по умолчанию, а CharPrevExA указывает кодовую страницу для использования.

Эта функция работает с ожиданиями пользователей по умолчанию для символов при работе с диакритиками. Например: строка, содержащая U+0061 U+030a "LATIN SMALL LETTER A" + COMBINING RING ABOVE, которая выглядит как "å", будет продвигать два кодовых пункта, а не один. Строка, содержащая U+0061 U+0301 U+0302 U+0303 U+0304 , которая выглядит как "a'^~ ̄", будет продвигать пять точек кода, а не одну и т. д.

Заметка

Заголовок winuser.h определяет CharPrev как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll