_strninc, _wcsninc, _mbsninc, _mbsninc_l

Статья
06/09/2015

Перемещает указатель строки на n символов.

Важно!

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

char *_strninc(
   const char *str,
   size_t count 
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count 
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count 
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);

Параметры

str
Исходная строка.
count
Число символов, на которое необходимо переместить указатель строки.
locale
Языковой стандарт, который необходимо использовать.

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

Каждая из этих процедур возвращает указатель на str после того, как str была перенесена на count символов, или NULL, если данный указатель имеет значение NULL. Если count больше или равно числу знаков в str, то результат не определен.

Заметки

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

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определены	_MBCS определено	_UNICODE определено
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc и _wcsninc являются версиями _mbsninc для строк однобайтовых и многобайтовых символов. _wcsninc и _strninc предоставляются только для этого сопоставления и не должны использоваться в других случаях. Дополнительные сведения см. в разделах Использование универсальных текстовых сопоставлений и Универсальные текстовые сопоставления.

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