_strninc, _wcsninc, _mbsninc, _mbsninc_l

Avance un pointeur de chaîne par n caractères.

Important

_mbsninc et _mbsninc_l ne peuvent pas être utilisées dans les applications qui s'exécutent dans Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge dans les applications de la plateforme Windows universelle.

Syntaxe

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

Paramètres

str
Chaîne source.

count
Nombre de caractères dont un pointeur de chaîne est incrémenté.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Chacune de ces routines retourne un pointeur vers str après que str a été incrémenté de count caractères ou NULL si le pointeur fourni a la valeur NULL. Si la valeur de count est supérieure ou égale au nombre de caractères contenus dans str, le résultat n’est pas défini.

Notes

La fonction _mbsninc incrémente str de count caractères multioctets. _mbsninc reconnaît les séquences de caractères multioctets en fonction de la page de codes multioctets en cours d’utilisation.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routine de texte générique

Routine Tchar.h	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc et _wcsninc sont des versions de chaîne à caractères simples et de chaînes à caractères larges de _mbsninc. _wcsninc et _strninc sont fournis uniquement pour ce mappage et ne doivent pas être utilisés dans le cas contraire. Pour plus d’informations, consultez Utilisation de mappages de texte générique et de mappages de texte générique.

La fonction _mbsninc_l est identique, sauf qu’elle utilise à la place les paramètres régionaux transmis. Pour plus d’informations, consultez Locale.

Spécifications

Routine	En-tête requis
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

Manipulation de chaîne
Paramètres régionaux
Interprétation des séquences de caractères multioctets
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l