_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l

Article
06/09/2015

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

Important

_mbsnextc et _mbsnextc_l ne peuvent pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

unsigned int _strnextc(
   const char *str
);
unsigned int _wscnextc(
   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 de retour

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 multi-octets suivant dans str, sans déplacer le pointeur de chaîne. _mbsnextc identifie des séquences de caractères multi-octets selon la page de codes multi-octets en cours d'utilisation.

Si str est NULL, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, errno is affecté à la valeur EINVAL et la fonction retourne 0.

Note de sécurité Cette API entraîne un risque potentiel provoqué par 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 Solutions contre les dépassements de mémoire tampon.

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_tcsnextc	_strnextc	_mbsnextc	_wcsnextc

_strnextc et _wcsnextc sont des versions de _mbsnextc traitant des chaînes de caractères sur un seul octet et à caractères élargis respectivement. _wcsnextc retourne la valeur entière du caractère élargi suivant dans string; _strnextc retourne la valeur entière du caractère codé sur un octet suivant dans string. _strnextc et _wcsnextc sont fournis uniquement pour ce mappage et ne doivent pas être utilisés sinon. Pour plus d'informations, consultez Utilisation des mappages de texte générique et Mappages de texte générique.

_mbsnextc_l est identique sauf qu'il utilise à la place les paramètres régionaux qui sont passés. Pour plus d'informations, consultez Paramètres régionaux.