strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Artykuł
06/09/2015

Skanowanie ciągu do ostatniego wystąpienia znaku.

Ważne
_mbsrchr i _mbsrchr_l nie można używać w aplikacjach korzystających ze środowiska wykonawczego systemu Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /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

Parametry

str
Ciąg zakończony wartością null do przeszukania.
c
Znak się znajdować.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

Zwraca wskaźnik do ostatniego wystąpienia c w str, lub NULL Jeśli c nie można odnaleźć.

Uwagi

strrchr Funkcja znajduje ostatnie wystąpienie c (przekonwertowany na char) w str.Wyszukiwanie uwzględnia kończącego znaku null.

wcsrchr i _mbsrchr są wersjami znaków dwubajtowych i znaków wielobajtowych strrchr.Argumenty i wartości zwracanej przez wcsrchr są ciągi znaków wide; tych z _mbsrchr są ciągami znaków wielobajtowych.

W języku C, te funkcje podejmują wskaźnik const dla pierwszego argumentu.W języku C++ dostępne są dwa przeciążenia.Przeciążenie wskaźnika do const zwraca wskaźnik do const; numeru wersji, która ma wskaźnik do non -const zwraca wskaźnik do non -const._CONST_CORRECT_OVERLOADS makro jest zdefiniowany, jeśli oba const i nie const wersje tych funkcji są dostępne.Jeśli wymagasz zachowania nie-const dla obu przeciążeń C++, określ symbol _CONST_RETURN.

_mbsrchr sprawdza poprawność parametrów.Jeśli wskaźnik str ma wartość NULL, zostanie wywołany nieprawidłowy parametr uchwytu wskaźnika, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie będzie mógł kontynuować, errno jest ustawiona na EINVAL i _mbsrchr zwraca wartość 0.strrchr i wcsrchr nie sprawdza poprawności ich parametrów.Te trzy funkcje w innych wypadkach zachowują się identycznie.

Wartość wyjściowa jest zależny od ustawienia z LC_CTYPE kategorii ustawienia określone w ustawieniach regionalnych; Aby uzyskać więcej informacji, zobacz setlocale.Wersje tych funkcji, które nie mają przyrostka _l używają bieżących ustawień regionalnych dla wszelkich zachowań zależnych od ustawień lokalnych; wersje, które mają przyrostek _l są identyczne, z tą różnicą, że w zamian korzystają z przekazanego parametru ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Regionalne.

Rutynowe mapowania zwykłego tekstu