strrchr、 wcsrchr、 _mbsrchr、 _mbsrchr_l

發行項
03/26/2013

掃描字元最後一次出現的字串。

重要

_mbsrchr 和 _mbsrchr_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /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

參數

str
從中搜尋的 NULL 結尾字串。
c
要尋找的字元。
locale
使用的地區設定。

傳回值

如果找不到 c ，傳回 c 的指標最後出現在 str的 NULL。

備註

strrchr 函式會在最後一次出現 c (轉換為 char) str。這項搜尋包含結束的 null 字元。

wcsrchr 和 _mbsrchr 是 strrchr 的寬字元和多位元組字元版本。引數和傳回值 wcsrchr是寬字元字串;這些 _mbsrchr 是多位元組字元字串。

在 C 裏，這些函式的第一個引數採用 const 的指標。在 C++ 裏，有兩個多載版本可供使用。多載的一個版本接受 const 的指標並回傳 const 的指標。另一個則接受 const 的指標並回傳非 const 的指標。如果 const 和非 const 的版本均可用，會定義巨集 _CONST_CORRECT_OVERLOADS 。如果您需要 C++ 兩個多載版本有非 const 的行為，請定義符號 _CONST_RETURN 。

_mbsrchr 會驗證其參數。如果 str 是 NULL ，無效參數處理常式會被調用，如參數驗證中所述。如果執行允許繼續， errno設定為 EINVAL和 _mbsrchr會傳回 0。 strrchr 和 wcsrchr 並不驗證它們的參數。這三個函式其餘部分的運作相同。

輸出值受地區設定的 LC_CTYPE類別設定的設定所影響;如需詳細資訊，請參閱 setlocale。這些函式沒有以 _l 後綴的版本在這些地區相依的行為上使用目前的地區設定，而以 _l 後綴版本除了它們會使用傳入的地區設定參數之外運作相同。如需詳細資訊，請參閱地區設定。

泛用文字常式對應