Поделиться через


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

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

Синтаксис

LPSTR CharNextA(
  [in] LPCSTR lpsz
);

Параметры

[in] lpsz

Тип: LPCTSTR

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

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

Тип: LPTSTR

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

Если lpsz указывает на завершающий символ NULL, возвращаемое значение равно lpsz.

Замечания

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

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

Заметка

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

Требования

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

См. также

CharNextExA

CharPrev

концептуальные

Справочник

строки