# std::wcscat

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

Appends a copy of the wide string pointed to by src to the end of the wide string pointed to by dest. The wide character src[0] replaces the null terminator at the end of dest.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cwchar>
wchar_t* wcscat( wchar_t* dest, const wchar_t* src );
```

Appends a copy of the wide string pointed to by `src` to the end of the wide string pointed to by `dest`. The wide character `src[0]` replaces the null terminator at the end of `dest`. The resulting wide string is null-terminated.

The behavior is undefined if the destination array is not large enough for the contents of both `src` and `dest` and the terminating null wide character.

The behavior is undefined if the strings overlap.

### Parameters

- `dest` - pointer to the null-terminated wide string to append to
- `src` - pointer to the null-terminated wide string to copy from

### Return value

Returns a copy of `dest`.

### Example

```cpp
#include <clocale>
#include <cwchar>
#include <iostream>

int main(void)
{
    wchar_t str[50] = L"Земля, прощай.";
    std::wcscat(str, L" ");
    std::wcscat(str, L"В добрый путь.");

    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    std::wcout << str << '\n';
}
```

Possible output:

```text
Земля, прощай. В добрый путь.
```

### See also

- [`wcsncat`](https://en.cppreference.com/w/cpp/string/wide/wcsncat): appends a certain amount of wide characters from one wide string to another (function)
- [`strcat`](https://en.cppreference.com/w/cpp/string/byte/strcat): concatenates two strings (function)
- [`wcscpy`](https://en.cppreference.com/w/cpp/string/wide/wcscpy): copies one wide string to another (function)
- [C documentation for `wcscat`](https://en.cppreference.com/w/c/string/wide/wcscat)

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