strlen, strnlen_s
来自cppreference.com
在标头 <string.h> 定义
|
||
size_t strlen( const char* str ); |
(1) | |
(2) | (C11 起) | |
1) 返回给定空终止字符串的长度,即首元素为 str 所指的字符数组中,直至且不包含首个空字符的字符数。
若 str 不是指向空终止字节字符串的指针则行为未定义。
2) 同 (1),但若 str 为空指针则返回零,而若在 str 的首 strsz 个字节找不到空字符则返回 strsz。
若 str 不是指向空终结的字节字符串且 strsz 大于该字符数组的大小,则行为未定义。
- 同所有边界检查函数,
strnlen_s
,仅若实现定义 __STDC_LIB_EXT1__ 且用户在包含 <string.h> 前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。
参数
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("不计入空字符: %zu\n", strlen(str)); printf("计入空字符: %zu\n", sizeof str); #ifdef __STDC_LIB_EXT1__ printf("不计入空字符: %zu\n", strnlen_s(str, sizeof str)); #endif }
可能的输出:
不计入空字符: 45 计入空字符: 46 不计入空字符: 45
引用
- C23 标准(ISO/IEC 9899:2024):
- 7.24.6.3 The strlen function (第 TBD 页)
- K.3.7.4.4 The strnlen_s function (第 TBD 页)
- C17 标准(ISO/IEC 9899:2018):
- 7.24.6.3 The strlen function (第 TBD 页)
- K.3.7.4.4 The strnlen_s function (第 TBD 页)
- C11 标准(ISO/IEC 9899:2011):
- 7.24.6.3 The strlen function (第 372 页)
- K.3.7.4.4 The strnlen_s function (第 623 页)
- C99 标准(ISO/IEC 9899:1999):
- 7.21.6.3 The strlen function (第 334 页)
- C89/C90 标准(ISO/IEC 9899:1990):
- 4.11.6.3 The strlen function
参阅
(C95)(C11) |
返回宽字符串的长度 (函数) |
返回下一个多字节字符的字节数 (函数) |