std::wcscat

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

Присоединяет копию широкой строки, на которую указывает src, к концу широкой строки, на которую указывает dest. Широкий символ src[0] заменяет нулевой терминатор в конце dest. Результирующая широкая строка завершается нулём.

Поведение является неопределённым, если целевой массив недостаточно велик, чтобы содержать содержимое как src, так и dest, а также завершающий нулевой широкий символ.

Поведение является неопределённым, если строки перекрываются.

Параметры

dest	-	указатель на завершающуюся нулём широкую строку, к которой нужно добавить
src	-	указатель на завершающуюся нулём широкую строку, из которой нужно скопировать

Возвращаемое значение

Возвращает копию dest.

Пример

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

Возможный вывод:

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

См. также

wcsncat	присоединяет определённое количество широких символов из одной широкой строки к другой (функция)
strcat	конкатенирует две строки (функция)
wcscpy	копирует одну широкую строку в другую (функция)
Документация на C для `wcscat`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/wide/wcscat