strchr
, wcschr
, _mbschr
, _mbschr_l
現在のロケールまたは指定された LC_CTYPE
変換状態カテゴリを使用し、文字列内の文字を探します。
重要
_mbschr
および _mbschr_l
は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
char *strchr(
const char *str,
int c
); // C only
char *strchr(
char * str,
int c
); // C++ only
const char *strchr(
const char * str,
int c
); // C++ only
wchar_t *wcschr(
const wchar_t *str,
wchar_t c
); // C only
wchar_t *wcschr(
wchar_t *str,
wchar_t c
); // C++ only
const wchar_t *wcschr(
const wchar_t *str,
wchar_t c
); // C++ only
unsigned char *_mbschr(
const unsigned char *str,
unsigned int c
); // C only
unsigned char *_mbschr(
unsigned char *str,
unsigned int c
); // C++ only
const unsigned char *_mbschr(
const unsigned char *str,
unsigned int c
); // C++ only
unsigned char *_mbschr_l(
const unsigned char *str,
unsigned int c,
_locale_t locale
); // C only
unsigned char *_mbschr_l(
unsigned char *str,
unsigned int c,
_locale_t locale
); // C++ only
const unsigned char *_mbschr_l(
const unsigned char *str,
unsigned int c,
_locale_t locale
); // C++ only
パラメーター
str
NULL で終わる元の文字列。
c
検索する文字。
locale
使用するロケール。
戻り値
これらの各関数は、in の最初のc
str
出現箇所へのポインターを返します。見NULL
つからない場合c
は、ポインターが返されます。
解説
この関数は strchr
in の最初のc
str
出現箇所を検索するか、見つからない場合c
は返しますNULL
。 検索対象には終端の null 文字が含まれます。
wcschr
関数、_mbschr
関数、および _mbschr_l
関数は、strchr
関数のワイド文字バージョンとマルチバイト文字バージョンです。 引数と戻り値 wcschr
はワイド文字列です。 引数と戻り値 _mbschr
はマルチバイト文字列です。 _mbschr
はマルチバイト文字シーケンスを認識します。 また、文字列が null ポインターの場合は、「_mbschr
パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、_mbschr
は NULL
を返し、errno
を EINVAL
に設定します。 strchr
パラメーター wcschr
を検証しません。 それ以外では、これらの関数の動作は同じです。
出力値は、ロケールの LC_CTYPE
カテゴリの設定に影響されます。詳細については、setlocale
を参照してください。 _l
サフィックスが付いていないこれらの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l
サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。 詳細については、「 Locale」を参照してください。
C では、これらの関数は、最初の引数に const
ポインターを受け取ります。 C++ では、2 つのオーバーロードを使用できます。 const
へのポインターを受け取るオーバーロードでは、const
へのポインターが返されます。非 const
へのポインターを受け取るバージョンでは、非 const
へのポインターが返されます。 これらの関数の const
と非 const
の両方のバージョンを使用できる場合、_CRT_CONST_CORRECT_OVERLOADS
というマクロが定義されます。 C++ のいずれのオーバーロードでも、非 const
の動作が求められる場合は、シンボル _CONST_RETURN
を定義してください。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
TCHAR.H ルーチン |
_UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
---|---|---|---|
_tcschr |
strchr |
_mbschr |
wcschr |
必要条件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
strchr |
<string.h> |
wcschr |
<string.h> または <wchar.h> |
_mbschr , _mbschr_l |
<mbstring.h> |
互換性の詳細については、「互換性」をご覧ください。
例
// crt_strchr.c
//
// This program illustrates searching for a character
// with strchr (search forward) or strrchr (search backward).
//
#include <string.h>
#include <stdio.h>
int ch = 'r';
char string[] = "The quick brown dog jumps over the lazy fox";
char fmt1[] = " 1 2 3 4 5";
char fmt2[] = "12345678901234567890123456789012345678901234567890";
int main( void )
{
char *pdest;
int result;
printf_s( "String to be searched:\n %s\n", string );
printf_s( " %s\n %s\n\n", fmt1, fmt2 );
printf_s( "Search char: %c\n", ch );
// Search forward.
pdest = strchr( string, ch );
result = (int)(pdest - string + 1);
if ( pdest != NULL )
printf_s( "Result: first %c found at position %d\n",
ch, result );
else
printf_s( "Result: %c not found\n", ch );
// Search backward.
pdest = strrchr( string, ch );
result = (int)(pdest - string + 1);
if ( pdest != NULL )
printf_s( "Result: last %c found at position %d\n", ch, result );
else
printf_s( "Result:\t%c not found\n", ch );
}
String to be searched:
The quick brown dog jumps over the lazy fox
1 2 3 4 5
12345678901234567890123456789012345678901234567890
Search char: r
Result: first r found at position 12
Result: last r found at position 30
関連項目
文字列操作
ロケール
マルチバイト文字シーケンスの解釈
strcspn
, wcscspn
, _mbscspn
, _mbscspn_l
strncat
, _strncat_l
, wcsncat
, _wcsncat_l
, _mbsncat
, _mbsncat_l
strncmp
, wcsncmp
, _mbsncmp
, _mbsncmp_l
strncpy
, _strncpy_l
, wcsncpy
, _wcsncpy_l
, _mbsncpy
, _mbsncpy_l
_strnicmp
, _wcsnicmp
, _mbsnicmp
, _strnicmp_l
, _wcsnicmp_l
, _mbsnicmp_l
strpbrk
, wcspbrk
, _mbspbrk
, _mbspbrk_l
strrchr
, wcsrchr
, _mbsrchr
, _mbsrchr_l
strstr
, wcsstr
, _mbsstr
, _mbsstr_l
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示