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.