CKTIS / C
wcscpy — copiar una cadena de caracteres anchos
wcscpy copia una cadena wchar_t, incluido su terminador. El búfer de destino debe ser lo bastante grande y las regiones copiadas no deben solaparse.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);wcscpy, declarada en <wchar.h>, copia la cadena de s2 a s1, incluido el L'\0' final. Devuelve s1, no la longitud de la copia.
El destino debe permitir escritura y contener al menos wcslen(s2) + 1 elementos de tipo wchar_t, no bytes. La fuente debe estar terminada. Un búfer demasiado pequeño, los punteros no válidos o las regiones copiadas solapadas provocan un comportamiento indefinido.
La función no recibe la capacidad del búfer ni realiza conversiones de codificación. El ejemplo reserva espacio también para el terminador; muestra la longitud y el resultado de comparar el puntero devuelto con dst.
Ejemplos
#include <stdio.h>
#include <wchar.h>
int main(void)
{
const wchar_t src[] = L"Hello";
wchar_t dst[sizeof src / sizeof src[0]];
wchar_t *result = wcscpy(dst, src);
printf("length=%zu, same_pointer=%d\n",
wcslen(dst), result == dst);
return 0;
}Resultado
length=5, same_pointer=1
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.