_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l

Находит следующий символ в строке.

Важно!

Функции _mbsnextc и _mbsnextc_l не могут использоваться в приложениях, запускаемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

unsigned int _strnextc(
   const char *str
);
unsigned int _wcsnextc(
   const wchar_t *str
);
unsigned int _mbsnextc(
   const unsigned char *str
);
unsigned int _mbsnextc_l(
   const unsigned char *str,
   _locale_t locale
);

Параметры

str
Исходная строка.

locale
Используемый языковой стандарт.

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

Каждая из этих функций возвращает целочисленное значение следующего символа в str.

Замечания

Функция _mbsnextc возвращает целочисленное значение следующего многобайтового символа в str, не перемещая указатель на строку. Функция _mbsnextc распознает последовательности многобайтовых символов в соответствии с текущей используемой многобайтовой кодовой страницей.

В противном strNULLслучае вызывается недопустимый обработчик параметров, как описано в разделе "Проверка параметров". Если выполнение может быть продолжено, параметр errno устанавливается в значение EINVAL и функция возвращает значение 0.

Примечание о безопасности. Эти функции предполагают потенциальную угрозу, связанную с проблемой переполнения буфера. Проблемы переполнения буфера — это распространенный метод атак на системы, который приводит к несанкционированному повышению уровня прав. Дополнительные сведения см. в разделе "Избегание переполнения буфера".

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_tcsnextc	_strnextc	_mbsnextc	_wcsnextc

_strnextc и _wcsnextc являются однобайтовыми и широкозначными версиями _mbsnextcстрок. _wcsnextc возвращает целочисленное значение следующего расширенного символа в str; _strnextc возвращает целочисленное значение следующего однобайтового символа в str. _strnextc и _wcsnextc предоставляются только для этого сопоставления и не должны использоваться в противном случае. Дополнительные сведения см. в разделе "Использование универсальных текстовых сопоставлений и универсальных текстовых сопоставлений".

_mbsnextc_l идентична указанной за исключением того, что использует языковой стандарт, переданный в качестве параметра. Дополнительные сведения см. в разделе Locale.

Требования

Маршрут	Обязательный заголовок
_mbsnextc	<mbstring.h>
_mbsnextc_l	<mbstring.h>
_strnextc	<tchar.h>
_wcsnextc	<tchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

Обработка строк
Локаль
Интерпретация последовательностей многобайтовых символов
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strninc, _wcsninc, _mbsninc, _mbsninc_l