Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes