std::wcsncpy

< cpp‎ | string‎ | wide
 
C++
 
字符串库
 
空终止宽字符串
 
定义于头文件 <cwchar>
wchar_t *wcsncpy( wchar_t *dest, const wchar_t *src, std::size_t count );

复制 src 所指向的宽字符串的至多 count 个字符（包含终止空宽字符）到 dest 所指向的宽字符数组。

若在完全复制整个 src 数组前抵达 count ，则产生的宽字符数组不是空终止的。

若在复制来自 src 的终止空宽字符后未抵达 count ，则写入额外的空宽字符到 dest ，直至写入总共 count 个字符。

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

参数

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

返回值

dest

注意

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

示例

运行此代码
#include <iostream>
#include <cwchar>
 
int main()
{
    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); // 这将复制 hi 并重复 \0 三次
 
    std::wcout << "The contents of dest are: ";
    for(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

参阅

 复制一个宽字符串到另一个
(函数)
在两个不重叠数组间复制一定量宽字符
(函数)
复制来自一个字符串的一定量字符给另一个
(函数)