strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Artigo
02/25/2013

Verificação uma cadeia de caracteres para a última ocorrência de um caractere.

Importante
_mbsrchr e _mbsrchr_l não podem ser usados em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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 NULL- finalizada a pesquisa.
c
Caractere a ser localizado.
locale
A localidade usar.

Valor de retorno

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

Comentários

A função de strrchr localiza a ocorrência a mais recente de c (convertido em char) em str.A pesquisa inclui o caractere de terminação zero.

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

Em C, essas funções recebem um ponteiro de const para o primeiro argumento.Em C++, duas sobrecargas estão disponíveis.A sobrecarga que utiliza um ponteiro para const retorna um ponteiro para const; a versão que tem um ponteiro paraconst não retorna um ponteiro paraconstnão-.O _CONST_CORRECT_OVERLOADS macro é definido se const e versões não- deconst dessas funções estão disponíveis.Se você não requer o comportamento deconst para ambas as sobrecargas de C++, defina o _CONST_RETURN do símbolo.

_mbsrchr valida os seus parâmetros.Se str é NULL, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, errnoé definido como EINVALe 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 categoria de LC_CTYPEde localidade; para obter mais informações, consulte setlocale.As versões dessas funções sem o sufixo de _l usam a localidade atual para este comportamento de são dependentes; as versões com o sufixo de _l são idênticas exceto que usam o parâmetro de localidade passado em vez disso.Para obter mais informações, consulte Localidade.

Mapeamentos da rotina de Genérico- texto