strrchr、wcsrchr、_mbsrchr、_mbsrchr_l
文字列をスキャンして最後に出現する文字を検索します。
重要
_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
使用するロケール。
戻り値
str で最後に見つかった c へのポインターを返すか、または c が見つからなかった場合は NULL を返します。
解説
strrchr 関数は、最後に出現する c を検索します (str で 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」を参照してください。
同等の .NET Framework 関数
参照
関連項目
strchr、wcschr、_mbschr、_mbschr_l
strcspn、wcscspn、_mbscspn、_mbscspn_l
_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l