_strninc, _wcsninc, _mbsninc, _mbsninc_l

Przechodzi wskaźnik ciągu przez n znaków.

Ważne

_mbsnincnie można jej _mbsninc_l używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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
Ciąg źródłowy.

count
Liczba znaków, które mają zwiększać wskaźnik ciągu.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Każda z tych procedur zwraca wskaźnik do wartości po str tym, jak został przyrostowany przez count znaki lub NULL jeśli podany wskaźnik to NULL.str Jeśli count wartość jest większa lub równa liczbie znaków w elemecie str, wynik jest niezdefiniowany.

Uwagi

Funkcja _mbsninc zwiększa się str o count znaki wielobajtowe. _mbsninc rozpoznaje sekwencje wielobajtowe znaków zgodnie ze stroną kodową wielobajtową, która jest obecnie używana.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura tchar.h _UNICODE i _MBCS niezdefiniowane _MBCS Zdefiniowane _UNICODE Zdefiniowane
_tcsninc _strninc _mbsninc _wcsninc

_strninci _wcsninc to ciąg jednobajtowy i wersje ciągów znaków szerokich znaków ._mbsninc _wcsninc i _strninc są udostępniane tylko dla tego mapowania i nie powinny być używane w przeciwnym razie. Aby uzyskać więcej informacji, zobacz Using generic-text mappings and Generic-text mappings (Używanie mapowań tekstu ogólnego i ogólnego tekstu).

_mbsninc_l jest identyczna, z tą różnicą, że używa parametru ustawień regionalnych przekazanych w zamian. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Wymagania

Procedura Wymagany nagłówek
_mbsninc <mbstring.h>
_mbsninc_l <mbstring.h>
_strninc <Tchar.h>
_wcsninc <Tchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

Manipulowanie ciągami
ustawienia regionalne
Interpretacja sekwencji znaków wielobajtowych
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l