wcscat, wcscat_s

1) Добавляет копию широкой строки, на которую указывает src , в конец широкой строки, на которую указывает dest . Широкий символ src[0] заменяет нулевой терминатор в конце dest . Результирующая широкая строка завершается нулевым символом. Поведение не определено, если целевой массив недостаточно велик для содержимого как str , так и dest и завершающего нулевого широкого символа. Поведение не определено, если строки перекрываются.

2) Аналогично (1) , за исключением того, что она может заполнить остаток массива назначения (начиная с последнего записанного символа до destsz ) неопределёнными значениями, а также следующие ошибки обнаруживаются во время выполнения и вызывают текущую установленную функцию обработки ограничений :

• src или dest является нулевым указателем
• destsz равен нулю или превышает RSIZE_MAX / sizeof ( wchar_t )
• отсутствует нулевой терминатор в первых destsz широких символах dest
• произойдёт усечение (доступного пространства в конце dest недостаточно для размещения всех широких символов, включая нулевой терминатор, из src )
• возникнет перекрытие между исходной и целевой строками

Как и все функции с проверкой границ, wcscat_s гарантированно доступна только если __STDC_LIB_EXT1__ определён реализацией и если пользователь определяет __STDC_WANT_LIB_EXT1__ как целочисленную константу 1 перед включением <wchar.h> .

1) возвращает копию dest

2) возвращает ноль при успехе, возвращает ненулевое значение при ошибке. Также при ошибке записывает L ' \0 ' в dest [ 0 ] (если только dest не является нулевым указателем или destsz не равен нулю или не больше RSIZE_MAX / sizeof ( wchar_t ) ).

#include <wchar.h> 
#include <stdio.h>
#include <locale.h>
int main(void) 
{
    wchar_t str[50] = L"Земля, прощай.";
    wcscat(str, L" ");
    wcscat(str, L"В добрый путь.");
    setlocale(LC_ALL, "en_US.utf8");
    printf("%ls", str);
}

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