strlen, strnlen_s
来自 cppreference.cn
| 定义于头文件 <string.h> |
||
| size_t strlen( const char* str ); |
(1) | |
| (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: TBD)
- K.3.7.4.4 strnlen_s 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018)
- 7.24.6.3 strlen 函数 (p: TBD)
- K.3.7.4.4 strnlen_s 函数 (p: TBD)
- 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 函数
[编辑] 参见
| (C95)(C11) |
返回宽字符串的长度 (函数) |
| 返回下一个多字节字符中的字节数 (函数) | |
| C++ 文档 关于 strlen
| |
