Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes