Namespaces
Variants

strlen, strnlen_s

From cppreference.net
< c ‎ | string ‎ | byte
C
Strings library
Null-terminated byte strings
Functions
Character manipulation
Conversions to and from numeric formats
String manipulation
String examination
Memory manipulation
Miscellaneous
(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 是空指针时函数返回零；若在前 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函数（页码：334）
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 4.11.6.3 strlen 函数

参阅

(C95) (C11)
返回宽字符串的长度
(函数)
返回下一个多字节字符的字节数
(函数)
C++ documentation for strlen