CKTIS / C
wcscpy — копиране на низ от широки символи
wcscpy копира низ wchar_t, включително завършващия го знак. Целевият буфер трябва да е достатъчно голям, а копираните области не бива да се припокриват.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);wcscpy, декларирана в <wchar.h>, копира низа от s2 в s1, включително крайния L'\0'. Връща s1, а не дължината на копието.
Целта трябва да позволява запис и да побира поне wcslen(s2) + 1 елемента от тип wchar_t, а не байта. Източникът трябва да е завършен. Недостатъчно голям буфер, невалидни указатели или припокриващи се копирани области водят до неопределено поведение.
Функцията не получава капацитет на буфера и не извършва преобразуване на кодировката. Примерът заделя място и за завършващия знак; извежда дължината и резултата от сравнението на върнатия указател с dst.
Примери
#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;
}Резултат
length=5, same_pointer=1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.