wcscat, wcscat_s

1) Añade 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 es indefinido si el array de destino no es lo suficientemente grande para los contenidos de tanto str como dest y el carácter ancho nulo terminador. El comportamiento es indefinido si las cadenas se superponen.

2) Igual que (1) , excepto que puede sobrescribir el resto del array de 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 constraint handler actualmente instalada:

• 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 cabría para cada carácter ancho, incluyendo el terminador nulo, de src )
• ocurriría superposición entre las cadenas fuente y destino

Como con todas las funciones con verificación de límites, wcscat_s solo está garantizada 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) retorna cero en caso de éxito, retorna distinto de cero en caso de error. Además, en caso de 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 <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);
}

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