std::wmemcpy

< cpp‎ | string‎ | wide
定义于头文件 <cwchar>
wchar_t* wmemcpy( wchar_t* dest, const wchar_t* src, std::size_t count );

src 所指向的宽字符数组准确复制 count 个相继的宽字符到 dest 所指向的宽字符数组。若对象重叠,则行为未定义。若 count 为零,则函数不做任何事。

参数

dest - 指向复制目标宽字符数组的指针
src - 指向复制来源宽字符数组的指针
count - 要复制的宽字符数

返回值

dest

注意

此函数对字节字符串的类似版本是 std::strncpy ,而非 std::strcpy

此函数不考虑本地环境,而且不关心其所复制的 wchar_t 对象的值:亦复制空字符还有非法字符。

示例

#include <iostream>
#include <cwchar>
#include <clocale>
#include <locale>
 
int main(void)
{
    wchar_t from1[] = L"नमस्ते";
    const size_t sz1 = sizeof from1 / sizeof *from1;
    wchar_t from2[] = L"Բարև";
    const size_t sz2 = sizeof from2 / sizeof *from2;
    wchar_t to[sz1 + sz2];
 
    std::wmemcpy(to, from1, sz1); // 复制 from1 ,沿着其空终止符
    std::wmemcpy(to + sz1, from2, sz2); // 后附 from2 ,沿着其空终止符
 
    std::setlocale(LC_ALL, "en_US.utf8");
    std::cout.imbue(std::locale("en_US.utf8"));
    std::wcout << "Wide array contains: ";
    for(size_t n = 0; n < sizeof to / sizeof *to; ++n)
        if(to[n])
            std::wcout << to[n];
        else
            std::wcout << "\\0";
    std::wcout << '\n';
}

可能的输出:

Wide array contains: नमस्ते\0Բարև\0

参阅

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