_strninc, _wcsninc, _mbsninc, _mbsninc_l

Wechselt einen Zeichenfolgenzeiger um n Zeichen.

Wichtig

_mbsninc und _mbsninc_l können nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

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

Parameter

str
Quellzeichenfolge.

count
Anzahl der Zeichen zum Erhöhen eines Zeichenfolgenzeigers.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

Jede dieser Routinen gibt einen Zeiger auf str zurück, nachdem str um count Zeichen erhöht wurde, oder gibt NULL zurück, wenn der angegebene Zeiger NULL ist. Wenn count größer oder gleich der Anzahl von Zeichen in str ist, ist das Ergebnis nicht definiert.

Hinweise

Die _mbsninc-Funktion erhöht str um count Multibytezeichen. _mbsninc erkennt Multibyte-Zeichenfolgen gemäß der aktuellen Multibyte-Codepage.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS Definiert	_UNICODE Definiert
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc und _wcsninc sind Einzelbyte-Zeichenfolgen- und Breitzeichen-Zeichenfolgenversionen von _mbsninc. _wcsninc und _strninc werden nur für diese Zuordnung bereitgestellt und sollten andernfalls nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von generischen Textzuordnungen und generischen Textzuordnungen.

_mbsninc_l ist nahezu identisch, verwendet jedoch stattdessen den übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Locale.

Anforderungen

Routine	Erforderlicher Header
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Zeichenfolgenmanipulation
Gebietsschema
Interpretation von Multibyte-Zeichensequenzen
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l