Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

wcscpy — kopiranje niza širokih znakov

wcscpy kopira niz wchar_t, vključno z zaključnim znakom. Ciljni medpomnilnik mora biti dovolj velik, kopirani območji pa se ne smeta prekrivati.

Različica: 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 v <wchar.h>, kopira niz iz s2 v s1, vključno s končnim L'\0'. Vrne s1, ne dolžine kopije.

Cilj mora biti zapisljiv in mora sprejeti vsaj wcslen(s2) + 1 elementov vrste wchar_t, ne bajtov. Vir mora biti zaključen. Premajhen medpomnilnik, neveljavni kazalci ali prekrivajoči se kopirani območji povzročijo nedefinirano vedenje.

Funkcija ne prejme velikosti medpomnilnika in ne izvaja pretvorbe kodiranja. Primer rezervira prostor tudi za zaključni znak; izpiše dolžino in rezultat primerjave vrnjenega kazalca z dst.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri