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.