_strninc, _wcsninc, _mbsninc, _mbsninc_l

Sposta in avanti un puntatore di stringa di n caratteri.

Importante

_mbsninc e _mbsninc_l non possono essere usati nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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

Parametri

str
Stringa di origine.

count
Numero di caratteri di cui incrementare un puntatore di stringa.

locale
Impostazioni locali da usare.

Valore restituito

Ognuna di queste routine restituisce un puntatore a str dopo aver incrementato str di count caratteri o NULL se il puntatore fornito è NULL. Se count è maggiore o uguale al numero di caratteri in str, il risultato è indefinito.

Osservazioni:

La funzione _mbsninc incrementa str di count caratteri multibyte. _mbsninc riconosce le sequenze di caratteri multibyte in base alla tabella codici multibyte attualmente in uso.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc e _wcsninc sono versioni di stringhe di caratteri a byte singolo e stringhe a caratteri wide di _mbsninc. _wcsninc e _strninc vengono forniti solo per questo mapping e non devono essere usati in caso contrario. Per altre informazioni, vedere Uso di mapping di testo generico e mapping di testo generico.

_mbsninc_l è identica, ma usa il parametro delle impostazioni locali passato. Per altre informazioni, vedere Locale.

Requisiti

Ciclo	Intestazione obbligatoria
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

Manipolazione delle stringhe
impostazioni locali
Interpretazione di sequenze di caratteri multibyte
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l