Freigeben über

_strninc, , _wcsninc_mbsninc_mbsninc_l

  • Artikel

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. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

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

Zeichenfolgenbearbeitung
Gebietsschema
Interpretation von Multibytezeichensequenzen
_strdec, , _wcsdec_mbsdec_mbsdec_l
_strinc, , _wcsinc_mbsinc_mbsinc_l
_strnextc, , _wcsnextc_mbsnextc_mbsnextc_l