_strninc, , _wcsninc_mbsninc, ,_mbsninc_l

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

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 routines de texte générique

_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

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

Voir aussi

Manipulation de chaînes
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