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

CKTIS / C

wcsncpy — ограничено копиране на широки символи

wcsncpy копира елементи wchar_t и допълва по-кратките резултати с нули, но не гарантира завършването на низа.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

wcsncpy от <wchar.h> копира от s2 в s1. Ограничението n брои елементи wchar_t, а не байтове. Функцията връща s1.

Ако източникът е по-кратък, се добавят елементи L'\0', докато бъдат записани точно n елемента. Ако първите n елемента не съдържат нула, резултатът не е завършен.

Целта трябва да побира n елемента; източникът трябва да може да се чете до първата нула или за n елемента. Припокриването на копираните области води до неопределено поведение. Ограничението не проверява капацитета на целта.

Примери

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    wchar_t padded[4];
    wchar_t cut[2];

    wcsncpy(padded, L"AB", 4);
    wcsncpy(cut, L"ABC", 2);

    printf("padding: %d %d\n",
           padded[2] == L'\0', padded[3] == L'\0');
    printf("prefix: %d %d\n", cut[0] == L'A', cut[1] == L'B');
    return 0;
}

Резултат

padding: 1 1
prefix: 1 1

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

Източници