std::wcsncpy

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

字符串库

以 null 结尾的字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

以 null 结尾的宽字符串

函数
字符操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11)   wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
转换为数字格式
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
字符串操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
数组操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset

 

定义在头文件 <cwchar> 中
wchar_t* wcsncpy( wchar_t* dest, const wchar_t* src, std::size_t count );

将 src 指向的宽字符串中最多 count 个字符（包括终止的空宽字符）复制到 dest 指向的宽字符数组中。

如果在复制完整个字符串 src 之前就达到了 count，则生成的宽字符数组不会以 null 结尾。

如果在从 src 复制终止的空宽字符后，尚未达到 count，则会将额外的空宽字符写入 dest，直到写入的字符总数达到 count。

如果字符串重叠，则行为未定义。

参数

dest	-	指向要复制到的宽字符数组的指针
src	-	指向要复制的宽字符串的指针
count	-	要复制的最大宽字符数

返回值

dest

备注

在典型用法中，count 是目标数组的大小。

示例

运行此代码

#include <cwchar>
#include <iostream>
 
int main()
{
    const wchar_t src[] = L"hi";
    wchar_t dest[6] = {L'a', L'b', L'c', L'd', L'e', L'f'};
 
    std::wcsncpy(dest, src, 5); // this will copy 'hi' and repeat \0 three times
 
    std::wcout << "The contents of dest are: ";
    for (const wchar_t c : dest)
    {
        if (c)
            std::wcout << c << ' ';
        else
            std::wcout << "\\0" << ' ';
    }
    std::wcout << '\n';
}

输出

The contents of dest are: h i \0 \0 \0 f

另请参阅

wcscpy	将一个宽字符串复制到另一个宽字符串 (函数)
wmemcpy	在两个非重叠数组之间复制一定数量的宽字符 (函数)
strncpy	从一个字符串复制一定数量的字符到另一个字符串 (函数)
C 文档 for wcsncpy