strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Examina una cadena para buscar la última repetición de un carácter.

System_CAPS_ICON_important.jpg Importante

_mbsrchr y _mbsrchr_l no se pueden usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para más información, vea Funciones de CRT no admitidas con /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  

Parámetros

str
Cadena terminada en NULL que se va a buscar.

c
Carácter que se va a buscar.

locale
Configuración regional que se va a usar.

Devuelve un puntero a la última aparición de c en str, o NULL si c no se encuentra.

La función strrchr encuentra la última repetición de c (convertida en char) en str. La búsqueda incluye el carácter nulo de terminación.

wcsrchr y _mbsrchr son versiones de caracteres anchos y multibyte de strrchr. Los argumentos y el valor devuelto de wcsrchr son cadenas de caracteres anchos; los de _mbsrchr son cadenas de caracteres multibyte.

En C, estas funciones toman un puntero const como primer argumento. En C++, hay disponibles dos sobrecargas. La sobrecarga que toma un puntero a const devuelve un puntero a const; la versión que contiene un puntero a un valor que no es const devuelve un puntero a un valor que no es const. La macro _CONST_CORRECT_OVERLOADS se define si están disponibles tanto las versiones const como no const de estas funciones. Si necesita un comportamiento que no sea const para ambas sobrecargas de C++, defina el símbolo _CONST_RETURN.

_mbsrchr valida sus parámetros. Si str es NULL, se invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, errno está establecido en EINVAL y _mbsrchr devuelve 0. strrchr y wcsrchr no validan sus parámetros. Estas tres funciones se comportan exactamente igual.

El valor de salida se ve afectado por el valor de la LC_CTYPE categoría de configuración de la configuración regional; para obtener más información, vea setlocale. Las versiones de estas funciones sin el sufijo _l usan la configuración regional actual de su comportamiento dependiente de la configuración regional; las versiones con el sufijo _l son idénticas salvo que usan el parámetro locale pasado en su lugar. Para obtener más información, vea Locale.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tcsrchrstrrchr_mbsrchrwcsrchr
n/dn/d_mbsrchr_ln/d
RutinaEncabezado necesario
strrchr<string.h>
wcsrchr<string.h> o <wchar.h>
_mbsrchr, _mbsrchr_l<mbstring.h>

Para obtener más información sobre la compatibilidad, vea Compatibilidad.

Para obtener un ejemplo del uso de strrchr, consulte strchr.

System::String::LastIndexOf

Manipulación de cadenas
Configuración regional
Interpretación de secuencias de caracteres Multibyte
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

Mostrar: