_strninc, _wcsninc, _mbsninc_mbsninc_l

Sposta in avanti un puntatore di stringa di n caratteri.

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

_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

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