wcslen, wcsnlen_s

在标头 `<wchar.h>` 定义
size_t wcslen( const wchar_t *str );	(1)	(C95 起)
size_t wcsnlen_s(const wchar_t *str, size_t strsz);	(2)	(C11 起)

1) 返回宽字符串的长度，即空终止宽字符之前的非空宽字符数。

2) 同 (1) ，除了若 str 为空指针则函数返回零，而若在 src 的首 strsz 个宽字符中找不到空宽字符则返回 strsz 。

同所有边界检查函数， wcsnlen_s 仅若实现定义了 __STDC_LIB_EXT1__ ，且用户在包含 wchar.h 前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。

参数

str	-	指向要检验的空终止宽字符串的指针
strsz	-	要检验的最大宽字符数

返回值

1) 空终止宽字符串 str 的长度。

2) 成功时为空终止宽字符串 str 的长度，若 str 为空指针则为零，若找不到空宽字符则为 strsz 。

注意

strnlen_s 和 wcsnlen_s 是仅有的不调用运行时制约处理的边界检查函数。它们是纯工具函数，用于为非空终止字符串提供有限制支持。

示例

运行此代码

#include <wchar.h>
#include <stdio.h>
 
int main(void)
{
    wchar_t str[] = L"How many wide characters does this string contain?";
 
    printf("without null character: %zu\n", wcslen(str));
    printf("with null character: %zu\n", sizeof str / sizeof *str);
}

输出：

without null character: 50
with null character: 51

引用

C11 标准（ISO/IEC 9899:2011）：

7.29.4.6.1 The wcslen function （第 439 页）

K.3.9.2.4.1 The wcsnlen_s function （第 646-647 页）

C99 标准（ISO/IEC 9899:1999）：

7.24.4.6.1 The wcslen function （第 385 页）

参阅

strlenstrnlen_s

(C11)

返回给定字符串的长度
(函数)

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

wcslen, wcsnlen_s

参数

返回值

注意

示例

引用

参阅

导航