Partager via


strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Analysez une chaîne pour la dernière occurrence d'un caractère.

Important

_mbsrchr et _mbsrchr_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

char *strrchr(
   const char *str,
   int c 
); // C only
char *strrchr(
   char *str,
   int c 
); // C++ only
const char *strrchr(
   const char *str,
   int c 
); // C++ only
wchar_t *wcsrchr(
   const wchar_t *str,
   wchar_t c 
); // C only
wchar_t *wcsrchr(
   wchar_t *str,
   wchar_t c 
); // C++ only
const wchar_t *wcsrchr(
   const wchar_t *str,
   wchar_t c 
); // C++ only
unsigned char *_mbsrchr(
   const unsigned char *str,
   unsigned int c 
); // C only
unsigned char *_mbsrchr(
   unsigned char *str,
   unsigned int c 
); // C++ only
const unsigned char *_mbsrchr(
   const unsigned char *str,
   unsigned int c 
); // C++ only
unsigned char *_mbsrchr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C only
unsigned char *_mbsrchr_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only
const unsigned char *_mbsrchr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only

Paramètres

  • str
    Chaîne terminée par le caractère NULL à trouver.

  • c
    Caractère à localiser.

  • locale
    Paramètres régionaux à utiliser.

Valeur de retour

Retourne un pointeur vers la dernière occurrence d' c dans str, ou NULLsi c est introuvable.

Notes

La fonction d' strrchr recherche la dernière occurrence d' c (converti en char) dans str.La recherche inclut le caractère NULL de fin.

wcsrchr et _mbsrchr sont à caractères larges et des versions à caractères multioctets d' strrchr.Les arguments et la valeur de retour d' wcsrchrsont des chaînes à caractères larges ; ces d' _mbsrchr sont des chaînes de caractères multioctets.

En C, ces fonctions prennent un pointeur d' const pour le premier argument.En C++, deux surcharges sont disponibles.La surcharge prenant un pointeur vers const retourne un pointeur vers const; la version qui prend un pointeur versconst non retourne un pointeur versconstnon.La macro _CONST_CORRECT_OVERLOADS est défini si const et les versions non d'const de ces fonctions sont disponibles.Si vous avez besoin d'un comportement non d'const pour les deux surcharges de C++, définissez le _CONST_RETURN de symboles.

_mbsrchr valide ses paramètres.Si str est NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, errnoa la valeur EINVALet retourne 0 d' _mbsrchr.strrchr et wcsrchr ne valident pas leurs paramètres.Ces trois fonctions se comportent de sinon.

La valeur de sortie est affectée par la configuration de la définition de catégorie d' LC_CTYPEdes paramètres régionaux ; pour plus d'informations, consultez l' setlocale.Les versions de ces fonctions sans suffixe d' _l utilisent les paramètres régionaux définis pour ce comportement dépendant des paramètres régionaux ; les versions avec le suffixe d' _l sont identiques sauf qu'elles utilisent le paramètre de paramètres régionaux passé à la place.Pour plus d'informations, consultez Paramètres régionaux.

Mappages de routines de texte générique

Routine de TCHAR.H

_UNICODE et non définis _MBCS

_MBCS défini

_UNICODE défini

_tcsrchr

strrchr

_mbsrchr

wcsrchr

N/A

N/A

_mbsrchr_l

N/A

Configuration requise

Routine

En-tête requis

strrchr

<string.h>

wcsrchr

<string.h> ou <wchar.h>

_mbsrchr, _mbsrchr_l

<mbstring.h>

Pour plus d'informations sur la compatibilité, consultez l' Compatibilité.

Exemple

Pour obtenir un exemple d'utilisation strrchr, consultez l' strchr.

Équivalent .NET Framework

System::String::LastIndexOf

Voir aussi

Référence

Manipulation de chaînes (CRT)

Paramètres régionaux

Interprétation des séquences de caractères multioctets

strchr, wcschr, _mbschr, _mbschr_l

strcspn, wcscspn, _mbscspn, _mbscspn_l

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

strspn, wcsspn, _mbsspn, _mbsspn_l