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

与所有边界检查函数一样，只有在实现定义了 __STDC_LIB_EXT1__ 且用户在包含 <stdio.h>.. 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时，wcslen_s 才保证可用。

[编辑] 参数

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 wcslen 函数 (p: 439)

K.3.9.2.4.1 wcsnlen_s 函数 (p: 646-647)

C99 标准 (ISO/IEC 9899:1999)

7.24.4.6.1 wcslen 函数 (p: 385)

[编辑] 另请参阅

strlenstrnlen_s (C11)	返回给定字符串的长度 (函数) [编辑]
C++ 文档 for wcslen

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

cppreference.com

命名空间

变体

视图

操作