strcspn

 

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>
size_t strcspn( const char *dest, const char *src );

返回指向dest的空終止位元組字串的最大初始段的長度，該段僅包含在指向src的空終止位元組字串中未找到的字元。

如果dest或src不是指向空終止位元組字串的指標，則行為未定義。

引數

dest	-	指向要分析的以空字元結尾的位元組字串的指標
src	-	指向包含要搜尋的字元的以空字元結尾的位元組字串的指標

返回值

最大初始段的長度，該段僅包含在指向src的空終止位元組字串中未找到的字元。

注意

該函式名稱代表“補餘跨度”（complementary span），因為該函式搜尋在src中未找到的字元，即src的補集。

示例

執行此程式碼

#include <string.h>
#include <stdio.h>
 
int main(void)
{
    const char *string = "abcde312$#@";
    const char *invalid = "*$#";
 
    size_t valid_len = strcspn(string, invalid);
    if(valid_len != strlen(string))
       printf("'%s' contains invalid chars starting at position %zu\n",
               string, valid_len);
}

輸出

'abcde312$#@' contains invalid chars starting at position 8

參考

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

• 7.24.5.3 strcspn 函式 (p: 368)

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

• 7.21.5.3 strcspn 函式 (p: 331)

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

• 4.11.5.3 strcspn 函式

另請參閱

strspn	返回由另一個位元組字串中找到的字元組成的最大初始段的長度 的字元 (函式)
wcscspn (C95)	返回由另一個位元組字串中找到的字元組成的最大初始段的長度 僅包含在另一個寬字串中未找到的寬字元 (函式)
strpbrk	在一個字串中查詢另一個字串中任意字元的第一個位置 (函式)
C++ 文件 for strcspn