命名空间
变体
操作

wcslen, wcsnlen_s

来自 cppreference.cn
< c‎ | string‎ | wide
在头文件 <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 是空指针则返回零,如果在前 strsz 个宽字符中未找到空宽字符则返回 strsz
与所有边界检查函数一样,只有当实现定义了 __STDC_LIB_EXT1__ 且用户在包含 <stdio.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时,才能保证 wcslen_s 可用。

目录

[编辑] 参数

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

[编辑] 返回值

1) 以空字符终止的宽字符串 str 的长度。
2) 成功时返回以空字符终止的宽字符串 str 的长度,如果 str 是空指针则返回零,如果未找到空宽字符则返回 strsz

[编辑] 注意

strnlen_swcsnlen_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)

[编辑] 另请参阅

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