strrchr、wcsrchr、_mbsrchr、_mbsrchr_l

發行項
06/09/2015

尋找字串中某個字元最後一次出現的位置。

重要

_mbsrchr and _mbsrchr_l不能用於在 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

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 在 str 中最後一次的出現 (轉換為 char) 。這項搜尋包含結束的 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 後綴版本除了它們會使用傳入的地區設定參數之外運作相同。如需詳細資訊，請參閱地區設定。

一般文字常式對應