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

CKTIS / C

wcsncpy — cópia limitada de caracteres largos

wcsncpy copia elementos wchar_t e preenche com zeros os resultados mais curtos, mas não garante a terminação da cadeia de caracteres.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <wchar.h>
wchar_t *wcsncpy(wchar_t * restrict s1, const wchar_t * restrict s2, size_t n);

wcsncpy, de <wchar.h>, copia de s2 para s1. O limite n conta elementos wchar_t, não bytes. A função devolve s1.

Se a origem for mais curta, são acrescentados elementos L'\0' até serem escritos exatamente n elementos. Se os primeiros n elementos não contiverem zero, o resultado não fica terminado.

O destino tem de comportar n elementos; a origem tem de poder ser lida até ao primeiro zero ou durante n elementos. A sobreposição das regiões copiadas causa comportamento indefinido. O limite não verifica a capacidade do destino.

Exemplos

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    wchar_t padded[4];
    wchar_t cut[2];

    wcsncpy(padded, L"AB", 4);
    wcsncpy(cut, L"ABC", 2);

    printf("padding: %d %d\n",
           padded[2] == L'\0', padded[3] == L'\0');
    printf("prefix: %d %d\n", cut[0] == L'A', cut[1] == L'B');
    return 0;
}

Resultado

padding: 1 1
prefix: 1 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