strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Artigo
06/09/2015

Examina uma cadeia de caracteres da última ocorrência de um caractere.

Importante

_mbsrchr e _mbsrchr_l não podem ser usados em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /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
Cadeia de caracteres terminada com Null para pesquisa.
c
Caractere a ser localizado.
locale
Localidade a ser usada.

Valor de retorno

Retorna um ponteiro para a última ocorrência em de c em str, ou NULL se c não for localizado.

Comentários

A função de strrchr localiza a última ocorrência de c (convertido em char) em str. A pesquisa inclui o caractere nulo sendo encerrado.

wcsrchr e _mbsrchr são versões de caracteres largos e de multibyte de strrchr. Os argumentos e o valor de retorno de wcsrchr são cadeias de caracteres de ampla caractere; essas de _mbsrchr são cadeias de caracteres de multibyte- caractere.

No C, essas funções têm um ponteiro de const para o primeiro argumento. No C++, duas sobrecargas estão disponíveis. A sobrecarga que usa um ponteiro para const retorna um ponteiro para const; a versão que usa um ponteiro para não const retorna um ponteiro para não const. A macro _CONST_CORRECT_OVERLOADS será definida se as versões const e não const dessas funções estiverem disponíveis. Se você não exigir o comportamento não const para as duas sobrecargas de C++, defina o símbolo _CONST_RETURN.

_mbsrchr valida seus parâmetros. Se str é NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução for permitida continuar, errno está definido como EINVAL e retorna 0 de _mbsrchr . strrchr e wcsrchr não validam seus parâmetros. Essas três funções se comportam de forma idêntica.

O valor de saída é afetado pela configuração da configuração da categoria de LC_CTYPE de localidade; para obter mais informações, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual para esse comportamento dependente da localidade; as versões com o sufixo _l são idênticas, exceto que elas usam o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.

Mapeamentos da rotina de texto genérico