strspn

 

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

返回指向 dest 的空終止位元組字串的最大初始段（跨度）的長度，該初始段僅由指向 src 的空終止位元組字串中找到的字元組成。

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

引數

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

返回值

最大初始段的長度，該初始段僅包含來自指向 src 的空終止位元組字串的字元。

示例

執行此程式碼

#include <stdio.h>
#include <string.h>
 
int main(void)
{
    const char* string = "abcde312$#@";
    const char* low_alpha = "qwertyuiopasdfghjklzxcvbnm";
 
    size_t spnsz = strspn(string, low_alpha);
    printf("After skipping initial lowercase letters from '%s'\n"
           "The remainder is '%s'\n", string, string + spnsz);
}

輸出

After skipping initial lowercase letters from 'abcde312$#@'
The remainder is '312$#@'

參考資料

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

• 7.24.5.6 strspn 函式 (p: TBD)

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

• 7.24.5.6 strspn 函式 (p: TBD)

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

• 7.24.5.6 strspn 函式 (p: 369)

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

• 7.21.5.6 strspn 函式 (p: 332)

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

• 4.11.5.6 strspn 函式

另請參閱

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