# std::wmemcpy

> C++ Atlas: `cppatlas.com/w/cpp/string/wide/wmemcpy` | Source: https://en.cppreference.com/w/cpp/string/wide/wmemcpy | Domain: Strings

Copies exactly count successive wide characters from the wide character array pointed to by src to the wide character array pointed to by dest.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cwchar>
wchar_t* wmemcpy( wchar_t* dest, const wchar_t* src, std::size_t count );
```

Copies exactly `count` successive wide characters from the wide character array pointed to by `src` to the wide character array pointed to by `dest`. If the objects overlap, the behavior is undefined. If `count` is zero, the function does nothing.

### Parameters

- `dest` - pointer to the wide character array to copy to
- `src` - pointer to the wide character array to copy from
- `count` - number of wide characters to copy

### Return value

`dest`

### Notes

This function's analog for byte strings is `std::strncpy`, not `std::strcpy`.

This function is not locale-sensitive and pays no attention to the values of the `wchar_t` objects it copies: nulls as well as invalid characters are copied too.

### Example

```cpp
#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';
}
```

Possible output:

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

### See also

- [`strncpy`](https://en.cppreference.com/w/cpp/string/byte/strncpy): copies a certain amount of characters from one string to another (function)
- [`wmemmove`](https://en.cppreference.com/w/cpp/string/wide/wmemmove): copies a certain amount of wide characters between two, possibly overlapping, arrays (function)
- [C documentation for `wmemcpy`](https://en.cppreference.com/w/c/string/wide/wmemcpy)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/wide/wmemcpy (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.