Sdílet prostřednictvím


_strninc, _wcsninc, _mbsninc, _mbsninc_l

Posune ukazatel řetězce o n znaků.

Důležité

_mbsninca _mbsninc_l nelze je použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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
);

Parametry

str
Zdrojový řetězec.

count
Počet znaků pro zvýšení ukazatele řetězce

locale
Národní prostředí, které se má použít.

Vrácená hodnota

Každá z těchto rutin vrátí ukazatel na str po str zvýšení o count znaky nebo NULL pokud je NULLzadaný ukazatel . Pokud count je větší nebo roven počtu znaků, strvýsledek není definován.

Poznámky

Funkce _mbsninc se zvýší str o count vícebajtové znaky. _mbsninc rozpozná vícebajtové sekvence znaků podle aktuálně používané znakové stránky s vícebajty.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina Tchar.h _UNICODE a _MBCS není definován _MBCS Definovány _UNICODE Definovány
_tcsninc _strninc _mbsninc _wcsninc

_strninc a _wcsninc jsou řetězce s jedním bajtem a verze řetězce s širokým znakem _mbsninc. _wcsninc a _strninc jsou k dispozici pouze pro toto mapování a neměly by se používat jinak. Další informace naleznete v tématu Použití mapování obecného textu a mapování obecného textu.

_mbsninc_l je shodný s tím rozdílem, že místo toho používá parametr národního prostředí předaný. Další informace naleznete v tématu Národní prostředí.

Požadavky

Rutina Požadovaný hlavičkový soubor
_mbsninc <mbstring.h>
_mbsninc_l <mbstring.h>
_strninc <Tchar.h>
_wcsninc <Tchar.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Viz také

Manipulace s řetězci
Národní prostředí
Interpretace vícebajtových sekvencí znaků
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l