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

  • Статья

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

Синтаксис

LPSTR CharNextA(
  [in] LPCSTR lpsz
);

Параметры

[in] lpsz

Тип: LPCTSTR

Символ в строке с пустым завершением.

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

Тип: LPTSTR

Возвращаемое значение является указателем на следующий символ в строке или на завершающий символ NULL, если он находится в конце строки.

Если 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

См. также раздел

CharNextExA

CharPrev

Основные понятия

Справочные материалы

Строки