strlen，strnlen_s

定义在头文件 `<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 大于该字符数组的大小，则行为未定义。

与所有边界检查函数一样，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("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++ 文档 for strlen

编译器支持
语言
头文件
类型支持
程序实用工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.com

命名空间

变体

视图

操作