Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

wcscpy — kopírovanie reťazca širokých znakov

wcscpy kopíruje reťazec wchar_t vrátane ukončovacieho znaku. Cieľový buffer musí byť dostatočne veľký a kopírované oblasti sa nesmú prekrývať.

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

Syntax

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

wcscpy, deklarovaná v <wchar.h>, kopíruje reťazec z s2 do s1 vrátane koncového L'\0'. Vracia s1, nie dĺžku kópie.

Cieľ musí byť zapisovateľný a musí pojať aspoň wcslen(s2) + 1 prvkov typu wchar_t, nie bajtov. Zdroj musí byť ukončený. Príliš malý buffer, neplatné ukazovatele alebo prekrývajúce sa kopírované oblasti spôsobujú nedefinované správanie.

Funkcia neprijíma kapacitu buffera a nevykonáva konverziu kódovania. Príklad rezervuje miesto aj na ukončovací znak; vypíše dĺžku a výsledok porovnania vráteného ukazovateľa s dst.

Prí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ýsledok

length=5, same_pointer=1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje