strrchr、wcsrchr、_mbsrchr、_mbsrchr_l

[アーティクル]
03/26/2013

文字の最後の生成の文字列をスキャンします。

重要
_mbsrchr と _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 がある strの 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、wcsrchr、_mbsrchr、_mbsrchr_l

パラメーター

戻り値

解説

必要条件

使用例

同等の .NET Framework 関数

参照

関連項目

その他のリソース