strchr
, wcschr
, _mbschr
, _mbschr_l
使用目前的地區設定或指定的 LC_CTYPE
轉換狀態類別,在字串中尋找字元。
重要
在 Windows 執行階段中執行的應用程式中無法使用 _mbschr
和 _mbschr_l
。 如需詳細資訊,請參閱 CRT functions not supported in Universal Windows Platform apps (通用 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
要使用的地區設定。
傳回值
所有這些函式都會傳回 中 str
第一次出現的 c
指標,如果 NULL
找不到 ,則 c
傳回 。
備註
函 strchr
式會尋找 中的 str
第一個出現專案 c
,如果 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++ 中,可使用兩個多載。 接受 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 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應