CKTIS / C
wcscpy — kopiranje niza širokih znakova
wcscpy kopira niz wchar_t, uključujući završni znak. Odredišni međuspremnik mora biti dovoljno velik, a kopirana područja ne smiju se preklapati.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);wcscpy, deklarirana u <wchar.h>, kopira niz iz s2 u s1, uključujući završni L'\0'. Vraća s1, a ne duljinu kopije.
Odredište mora biti zapisivo i mora moći sadržavati barem wcslen(s2) + 1 elemenata tipa wchar_t, a ne bajtova. Izvor mora biti završen. Premalen međuspremnik, nevaljani pokazivači ili preklapanje kopiranih područja uzrokuju nedefinirano ponašanje.
Funkcija ne prima kapacitet međuspremnika i ne izvodi pretvorbu kodiranja. Primjer rezervira prostor i za završni znak; ispisuje duljinu i rezultat usporedbe vraćenog pokazivača s dst.
Primjeri
#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;
}Rezultat
length=5, same_pointer=1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.