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 则行为未定义；换言之， 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 <string.h>
#include <stdio.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

示例

运行此代码

// c语言计算字符串长度默认都是以 ascii 编码作为计算单元，并非目前常用的 unicode 编码
// 下面是一段可以统计 utf8 中包含的 unicode 个数的代码
#include <stdio.h>
#include <stdint.h>
#include <stdlib.h>
#include <string.h>
 
// 该函数用来计算 字符串第一个字符转换成 unicode 所需的长度
uint64_t c8_to_c32_len(const char *restrict c8) {
    register uint8_t c = *c8;
 
    if (c == EOF || (c >= 0 && c < 0x80)) { /* [0x0, 0x7F] */
        return 1;
    } else if (c >= 0xC0 && c < 0xE0) { /* [0xC0, 0xDF] */
        return 2;
    } else if (c < 0xF0) { /* [0xE0, 0xEF] */
        return 3;
    } else if (c < 0xF8) { /* [0xF0, 0xF7] */
        return 4;
    } else if (c < 0xFC) { /* [0xF8, 0xFB] */
        return 5;
    } else if (c <= 0xFD) { /* [0xFC, 0xFD] */
        return 6;
    } else {
        return 1;
    }
}
 
// 按照 utf8 格式计算所包含 unicode 编码长度
uint64_t u8strlen(const char *restrict s8) {
    register uint64_t size = 0;
    while (*s8 != '\0') {
        s8 += c8_to_c32_len(s8);
        ++size;
    }
 
    return size;
}
 
int main() {
    const char *text = "你好，世界！！！ Hello World!!!";
    printf("strlen() = %lu\n", strlen(text));
    printf("u8strlen() = %lu\n", u8strlen(text));
    return 0;
}

输出：

strlen() = 39
u8strlen() = 23

引用

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

参阅

wcslenwcsnlen_s (C95)(C11)	返回宽字符串的长度 (函数)
mblen	返回下一个多字节字符的字节数 (函数)

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

strlen, strnlen_s

参数

返回值

注意

示例

示例

引用

参阅

导航