wcscpy, wcscpy_s

1) Copia la cadena ancha apuntada por src (incluyendo el carácter ancho nulo terminador) al arreglo de caracteres anchos apuntado por dest . El comportamiento es indefinido si el arreglo dest no es lo suficientemente grande. El comportamiento es indefinido si las cadenas se superponen.

2) Igual que (1) , excepto que puede sobrescribir el resto del array de destino con valores no especificados y que los siguientes errores se detectan en tiempo de ejecución y llaman a la función controladora de restricciones actualmente instalada:

• src o dest es un puntero nulo
• destsz es cero o mayor que RSIZE_MAX / sizeof ( wchar_t )
• destsz es menor o igual que wcsnlen_s ( src, destsz ) , en otras palabras, ocurriría truncamiento
• ocurriría superposición entre las cadenas de origen y destino

Como con todas las funciones con verificación de límites, wcscpy_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 RMAX_SIZE / sizeof ( wchar_t ) ).

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void)
{
    wchar_t* src = L"犬 means dog";
//  src[0] = L'狗' ; // this would be undefined behavior
    wchar_t dst[wcslen(src) + 1]; // +1 for the null terminator
    wcscpy(dst, src);
    dst[0] = L'狗'; // OK
    setlocale(LC_ALL, "en_US.utf8");
    printf("src = %ls\ndst = %ls\n", src, dst);
}

src = 犬 means dog
dst = 狗 means dog