strlen, strnlen_s

 

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 strlen( const char* str );	(1)
size_t strnlen_s( const char* str, size_t strsz );	(2)	(C11 起)

1) 返回給定以空字元結尾的位元組字串的長度，即一個字元陣列中的字元數量，該字元陣列的第一個元素由 str 指向，直到但不包括第一個空字元。

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

2) 與 (1) 相同，但如果 str 是空指標，則函式返回零；如果在 str 的前 strsz 個位元組中未找到空字元，則返回 strsz。

如果 str 不是指向以空字元結尾的位元組字串的指標，並且 strsz 大於該字元陣列的大小，則行為未定義。

與所有邊界檢查函式一樣，只有當實現定義了 __STDC_LIB_EXT1__ 且使用者在包含 <string.h> 之前將 __STDC_WANT_LIB_EXT1__ 定義為整數常量 1 時，才能保證 strnlen_s 可用。

引數

str	-	指向要檢查的以空字元結尾的位元組字串的指標
strsz	-	要檢查的最大字元數

返回值

1) 以空字元結尾的位元組字串 str 的長度。

2) 成功時，以空字元結尾的位元組字串 str 的長度；如果 str 是空指標，則為零；如果未找到空字元，則為 strsz。

注意

strnlen_s 和 wcsnlen_s 是唯一不呼叫執行時約束處理程式的邊界檢查函式。它們是純實用函式，用於為非空終止字串提供有限支援。

示例

執行此程式碼

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <string.h>
 
int main(void)
{
    const char str[] = "How many characters does this string contain?";
 
    printf("without null character: %zu\n", strlen(str));
    printf("with null character:    %zu\n", sizeof str);
 
#ifdef __STDC_LIB_EXT1__
    printf("without null character: %zu\n", strnlen_s(str, sizeof str));
#endif
}

可能的輸出

without null character: 45
with null character:    46
without null character: 45

參考

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

• 7.24.6.3 strlen 函式 (p: 待定)

• K.3.7.4.4 strnlen_s 函式 (p: 待定)

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

• 7.24.6.3 strlen 函式 (p: 待定)

• K.3.7.4.4 strnlen_s 函式 (p: 待定)

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

• 7.24.6.3 strlen 函式 (p: 372)

• K.3.7.4.4 strnlen_s 函式 (p: 623)

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

• 7.21.6.3 strlen 函式 (p: 334)

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

• 4.11.6.3 strlen 函式

另請參閱

wcslenwcsnlen_s (C95)(C11)	返回寬字串的長度 (函式)
mblen	返回下一個多位元組字元的位元組數 (函式)
C++ 文件 適用於 strlen