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

_strninc, , _wcsninc_mbsninc_mbsninc_l

  • Статья

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

Внимание

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

Синтаксис

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 распознает последовательности многобайтовых символов в соответствии с текущей используемой многобайтовой кодовой страницей.

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

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

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

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

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

Требования

Маршрут Обязательный заголовок
_mbsninc <mbstring.h>
_mbsninc_l <mbstring.h>
_strninc <tchar.h>
_wcsninc <tchar.h>

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

См. также

Обработка строк
Локаль
Интерпретация последовательностей многобайтовых символов
_strdec, , _wcsdec_mbsdec_mbsdec_l
_strinc, , _wcsinc_mbsinc_mbsinc_l
_strnextc, , _wcsnextc_mbsnextc_mbsnextc_l