std::wmemcpy

来自cppreference.com
< 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 <clocale>
#include <cwchar>
#include <iostream>
#include <iterator>
#include <locale>
 
int main(void)
{
    const wchar_t from1[] = L"नमस्ते";
    const wchar_t from2[] = L"Բարև";
    const std::size_t sz1 = std::size(from1);
    const std::size_t sz2 = std::size(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 << "宽数组包含: ";
    for (std::size_t n = 0; n < std::size(to); ++n)
        if (to[n])
            std::wcout << to[n];
        else
            std::wcout << L"\\0";
    std::wcout << L'\n';
}

可能的输出:

宽数组包含: नमस्ते\0Բարև\0

参阅

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