strlen, strnlen_s

来自cppreference.com
< c | string | byte
 
C
 
字符串库
 
空终止字节字符串
 
<tbody> </tbody>
在标头 <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。

注解

See More

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)
 返回宽字符串的长度
(函数) [编辑]
返回下一个多字节字符的字节数
(函数) [编辑]
strlen 的 C++ 文档