База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници