Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

wcscpy — kopírování řetězce širokých znaků

wcscpy kopíruje řetězec wchar_t včetně ukončovacího znaku. Cílový buffer musí být dostatečně velký a kopírované oblasti se nesmějí překrývat.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

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

wcscpy, deklarovaná v <wchar.h>, kopíruje řetězec z s2 do s1, včetně koncového L'\0'. Vrací s1, nikoli délku kopie.

Cíl musí být zapisovatelný a musí pojmout alespoň wcslen(s2) + 1 prvků typu wchar_t, nikoli bajtů. Zdroj musí být ukončený. Příliš malý buffer, neplatné ukazatele nebo překrývající se kopírované oblasti vedou k nedefinovanému chování.

Funkce nepřijímá kapacitu bufferu a neprovádí převod kódování. Příklad rezervuje místo také pro ukončovací znak; vypíše délku a výsledek porovnání vráceného ukazatele s dst.

Příklady

#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;
}

Výsledek

length=5, same_pointer=1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje