strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

 

Para obter a documentação mais recente do Visual Studio 2017 RC, consulte a documentação do Visual Studio 2017 RC.

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

System_CAPS_ICON_important.jpg Importante

_mbsrchre _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 de CRT não têm 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
Sequência de terminação nula para pesquisar.

c
Caractere a ser localizado.

locale
Localidade a usar.

Retorna um ponteiro para a última ocorrência de c na str, ou NULL se c não foi encontrado.

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

wcsrchre _mbsrchr são versões de caractere largo e caracteres multibyte strrchr. Os argumentos e o valor de retorno de wcsrchr são caracteres largos cadeias de caracteres; desses _mbsrchr são cadeias de caracteres multibyte.

Em C, essas funções usam um const ponteiro para o primeiro argumento. No C++, estão disponíveis duas sobrecargas. A sobrecarga de colocar 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 é definida se o const e não-const versões dessas funções estão disponíveis. Se você precisar nãoconst comportamento para as sobrecargas de C++, definir o símbolo _CONST_RETURN.

_mbsrchrvalida seus parâmetros. Se str é NULL, o manipulador de parâmetro inválido é invocado, conforme descrito em validação do parâmetro. Se a execução puder continuar, errno é definido como EINVAL e _mbsrchr retornará 0. strrchre wcsrchr não validam seus parâmetros. Essas três funções se comportam de forma idêntica caso contrário.

O valor de saída é afetado pela configuração do LC_CTYPE categoria configurações da localidade; para obter mais informações, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual desse comportamento dependente da localidade. As versões com o sufixo _l são idênticas, exceto por usarem o parâmetro de localidade passado em seu lugar. Para obter mais informações, consulte localidade.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H_UNICODE e _MBCS não definidos_MBCS definido_UNICODE definido
_tcsrchrstrrchr_mbsrchrwcsrchr
n/dn/d_mbsrchr_ln/d
RotinaCabeçalho necessário
strrchr<string.h>
wcsrchr<string.h> ou <wchar.h>
_mbsrchr, _mbsrchr_l<mbstring.h>

Para obter mais informações sobre compatibilidade, consulte compatibilidade.

Para obter um exemplo de uso strrchr, consulte strchr.

System::String::LastIndexOf

Manipulação de cadeia de caracteres
Localidade
Interpretação de sequências 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: