wcscat, wcscat_s

wchar_t* wcscat( wchar_t* dest, const wchar_t* src );

wchar_t* wcscat( wchar_t* restrict dest, const wchar_t* restrict src );

errno_t wcscat_s( wchar_t* restrict dest, rsize_t destsz,
                  const wchar_t* restrict src );

1) Agrega una copia de la cadena ancha apuntada por src al final de la cadena ancha apuntada por dest. El carácter ancho src[0] reemplaza el terminador nulo al final de dest. La cadena ancha resultante termina en nulo. El comportamiento no está definido si el arreglo destino no es lo suficientemente grande para el contenido de src y dest y el carácter ancho nulo de terminación. El comportamiento no está definido si las cadenas se superponen.

2) Igual que (1), excepto que puede sobrescribir el resto del arreglo destino (desde el último carácter escrito hasta destsz) con valores no especificados y que los siguientes errores se detectan en tiempo de ejecución y llaman a la función manejador de restricciones instalada actualmente:

• src o dest es un puntero nulo
• destsz es cero o mayor que RSIZE_MAX / sizeof(wchar_t)
• no hay terminador nulo en los primeros destsz caracteres anchos de dest
• ocurriría truncamiento (el espacio disponible al final de dest no podría albergar todos los caracteres anchos, incluido el terminador nulo, de src)
• ocurriría superposición entre la cadena origen y la cadena destino

Al igual que con todas las funciones con verificación de límites, wcscat_s solo se garantiza que esté disponible si __STDC_LIB_EXT1__ está definido por la implementación y si el usuario define __STDC_WANT_LIB_EXT1__ como la constante entera 1 antes de incluir <wchar.h>.

1) devuelve una copia de dest

2) devuelve cero en éxito, devuelve distinto de cero en error. Además, en error, escribe L'\0' en dest[0] (a menos que dest sea un puntero nulo o destsz sea cero o mayor que RSIZE_MAX / sizeof(wchar_t)).

#include <locale.h>
#include <stdio.h>
#include <wchar.h>

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

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