_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l

Статья
06/09/2015

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

Важно!

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

unsigned int _strnextc(
   const char *str
);
unsigned int _wscnextc(
   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 распознает многобайтовые последовательности символов в соответствии с использующейся многобайтовой кодовой страницей.

Если параметр str имеет значение NULL, вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, errno принимает значение EINVAL, и функция возвращает 0.

Замечание по безопасности Этот API создает потенциальную угрозу, вызываемую проблемой выхода за границы буфера. Ошибки переполнения буфера — частый метод атаки системы, в результате которого происходит несанкционированное получение прав. Дополнительные сведения см. в разделе Как избежать переполнения буфера.

Универсальное текстовое сопоставление функций

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

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

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