CKTIS / C
wcscpy — copiar uma cadeia de caracteres largos
wcscpy copia uma cadeia wchar_t, incluindo o respetivo terminador. O buffer de destino tem de ser suficientemente grande e as regiões copiadas não podem sobrepor-se.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);wcscpy, declarada em <wchar.h>, copia a cadeia de s2 para s1, incluindo o L'\0' final. Devolve s1, não o comprimento da cópia.
O destino tem de permitir escrita e conter pelo menos wcslen(s2) + 1 elementos do tipo wchar_t, não bytes. A origem tem de estar terminada. Um buffer demasiado pequeno, ponteiros inválidos ou regiões copiadas sobrepostas provocam comportamento indefinido.
A função não recebe a capacidade do buffer nem faz conversão de codificação. O exemplo reserva espaço também para o terminador; apresenta o comprimento e o resultado da comparação entre o ponteiro devolvido e dst.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.