_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l

Recherche le caractère suivant dans une chaîne.

Important

_mbsnextc et _mbsnextc_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

unsigned int _strnextc(
   const char *str
);
unsigned int _wcsnextc(
   const wchar_t *str
);
unsigned int _mbsnextc(
   const unsigned char *str
);
unsigned int _mbsnextc_l(
   const unsigned char *str,
   _locale_t locale
);

Paramètres

str
Chaîne source.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Chacune de ces fonctions retourne la valeur entière du caractère suivant dans str.

Notes

La fonction _mbsnextc retourne la valeur entière du caractère multioctet suivant dans str, sans faire avancer le pointeur de chaîne. _mbsnextc reconnaît les séquences de caractères multioctets en fonction de la page de codes multioctets en cours d’utilisation.

Si str c’est NULLle cas, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à se poursuivre, errno prend la valeur EINVAL et la fonction retourne 0.

Remarque relative à la sécurité Cette API est exposée à une menace potentielle liée à un problème de dépassement de mémoire tampon. Les dépassements de mémoire tampon sont une méthode fréquente d'attaque du système, ce qui provoque une élévation des privilèges injustifiée. Pour plus d’informations, consultez Éviter les dépassements de mémoire tampon.

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
_tcsnextc	_strnextc	_mbsnextc	_wcsnextc

_strnextc et _wcsnextc sont des versions de chaîne à caractères simples et de chaînes à caractères larges de _mbsnextc. _wcsnextc retourne la valeur entière du prochain caractère large situé dans str ; _strnextc retourne la valeur entière du prochain caractère codé sur un octet situé dans str. _strnextc et _wcsnextc 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 _mbsnextc_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
_mbsnextc	<mbstring.h>
_mbsnextc_l	<mbstring.h>
_strnextc	<tchar.h>
_wcsnextc	<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
_strninc, _wcsninc, _mbsninc, _mbsninc_l