_strninc, _wcsninc, , _mbsninc_mbsninc_l

Posune ukazatel řetězce o n znaků.

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

_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

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