Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori