std::wmemcpy
Определено в заголовке <cwchar> | ||
|---|---|---|
wchar_t* wmemcpy( wchar_t* dest, const wchar_t* src, std::size_t count ); |
Копирует ровно count последовательных широких символов из массива широких символов, на который указывает src, в массив широких символов, на который указывает 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); // copy from1, along with its null terminator
std::wmemcpy(to + sz1, from2, sz2); // append from2, along with its null terminator
std::setlocale(LC_ALL, "en_US.utf8");
std::wcout.imbue(std::locale("en_US.utf8"));
std::wcout << L"Wide array contains: ";
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';
}Возможный вывод:
Wide array contains: नमस्ते\0Բարև\0
См. также
| копирует определенное количество символов из одной строки в другую (функция) |
|
| копирует определенное количество широких символов между двумя, возможно перекрывающимися, массивами (функция) |
|
Документация C для wmemcpy |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/wide/wmemcpy
