次の方法で共有


strrchr、wcsrchr、_mbsrchr、_mbsrchr_l

更新 : 2007 年 11 月

文字列をスキャンして、指定された文字が最後に出現する位置を見つけます。

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
    使用するロケール。

戻り値

str 内で c が最後に出現する位置を指すポインタを返します。c が見つからない場合は、NULL を返します。

解説

strrchr 関数は、str 内で c (char 型に変換された値) が最後に出現する位置を検索します。検索には、終端の NULL 文字が含まれます。

wcsrchr と _mbsrchr は、strrchr のワイド文字バージョンとマルチバイト文字バージョンです。wcsrchr 関数の引数と戻り値はワイド文字列で、_mbsrchr 関数の引数と戻り値はマルチバイト文字列です。

C では、これらの関数は、最初の引数に const ポインタを受け取ります。C++ では、2 つのオーバーロードを使用できます。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 サフィックスが付いているバージョンは、渡されたロケール パラメータを代わりに使用する点を除いて同じです。詳細については、「ロケール」を参照してください。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_tcsrchr

strrchr

_mbsrchr

wcsrchr

適用なし

適用なし

_mbsrchr_l

適用なし

必要条件

ルーチン

必須ヘッダー

strrchr

<string.h>

wcsrchr

<string.h> または <wchar.h>

_mbsrchr, _mbsrchr_l

<mbstring.h>

互換性の詳細については、「互換性」を参照してください。

使用例

strrchr の使用例については、「strchr、wcschr、_mbschr、_mbschr_l」を参照してください。

.NET Framework の相当するアイテム

System::String::LastIndexOf

参照

参照

文字列操作 (CRT)

ロケール

マルチバイト文字のシーケンスの解釈

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