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.