_strninc, _wcsninc, _mbsninc, _mbsninc_l

Artikel
06/09/2015

Versetzt den Zeichenfolgenzeiger um n Zeichen nach vorn.

Wichtig

_mbsninc und _mbsninc_l können nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.

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.

Zuordnung generischer Textroutinen

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

_strninc und _wcsninc sind Versionen von Einzelbytezeichenfolgen und Zeichenfolgen mit Breitzeichen von _mbsninc. _wcsninc und _strninc werden nur für diese Zuordnung bereitgestellt und sollten nicht für andere Zwecke verwendet werden. Weitere Informationen finden Sie unter dem Thema zum Verwenden von generischen Textzuordnungen und Generische Textzuordnungen.

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