Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

wcscpy — kopiowanie łańcucha szerokich znaków

wcscpy kopiuje łańcuch wchar_t wraz z terminatorem. Bufor docelowy musi być dostatecznie duży, a obszary nie mogą się nakładać.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);

wcscpy, zadeklarowana w <wchar.h>, kopiuje łańcuch z s2 do s1, łącznie z końcowym L'\0'. Zwraca s1, nie długość kopii.

Cel musi być zapisywalny i mieścić co najmniej wcslen(s2) + 1 elementów wchar_t, nie bajtów. Źródło musi mieć terminator. Za mały bufor, nieprawidłowe wskaźniki lub nakładanie się kopiowanych obszarów powodują niezdefiniowane zachowanie.

Funkcja nie przyjmuje pojemności bufora ani nie konwertuje kodowania. Przykład rezerwuje miejsce także na terminator; wypisuje długość i wynik porównania zwróconego wskaźnika z dst.

Przykłady

#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;
}

Wynik

length=5, same_pointer=1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła