strchr

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

字串庫

空終止位元組字串

空終止多位元組字串

空終止寬字串

 

空終止位元組字串

函式
字元操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
與數字格式相互轉換
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字串檢查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
記憶體操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
雜項
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定義於標頭檔案 <string.h>
char* strchr( const char* str, int ch );	(1)
/*QChar*/ *strchr( /*QChar*/ *str, int ch );	(2)	(自 C23 起)

1) 在 `str` 指向的以空字元結尾的位元組字串中查詢 `ch` 的第一次出現（在轉換為 `char` 後，如同透過 `(char)ch` ）。終止空字元被認為是字串的一部分，可以在搜尋 `'\0'` 時找到。

2) 型別通用函式，等同於 (1)。令 T 為不合格字元物件型別。

• 如果 `str` 的型別是 `const T*`，則返回型別為 `const char*`。
• 否則，如果 `str` 的型別為 `T*`，則返回型別為 `char*`。
• 否則，行為未定義。

如果抑制了這些泛型函式中每個函式的宏定義以訪問實際函式（例如，如果使用了 `(strchr)` 或函式指標），則實際函式宣告 (1) 將可見。

如果 `str` 不是指向以空字元結尾的位元組字串的指標，則行為未定義。

引數

str	-	指向要分析的以空字元結尾的位元組字串的指標
ch	-	要搜尋的字元

返回值

指向 `str` 中找到的字元的指標，如果未找到該字元，則為空指標。

示例

執行此程式碼

#include <stdio.h>
#include <string.h>
 
int main(void)
{
    const char *str = "Try not. Do, or do not. There is no try.";
    char target = 'T';
    const char* result = str;
 
    while((result = strchr(result, target)) != NULL)
    {
        printf("Found '%c' starting at '%s'\n", target, result);
        ++result; // Increment result, otherwise we'll find target at the same location
    }
}

輸出

Found 'T' starting at 'Try not. Do, or do not. There is no try.'
Found 'T' starting at 'There is no try.'

參考

• C23 標準 (ISO/IEC 9899:2024)

• 7.24.5.2 strchr 函式 (p: 待定)

• C17 標準 (ISO/IEC 9899:2018)

• 7.24.5.2 strchr 函式 (p: 待定)

• C11 標準 (ISO/IEC 9899:2011)

• 7.24.5.2 strchr 函式 (p: 367-368)

• C99 標準 (ISO/IEC 9899:1999)

• 7.21.5.2 strchr 函式 (p: 330)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.11.5.2 strchr 函式

另請參閱

memchr	在陣列中搜索字元的第一次出現 (函式)
strrchr	查詢字元的最後一次出現 (函式)
strpbrk	在一個字串中查詢另一個字串中任意字元的第一個位置 (函式)
C++ 文件中的 strchr