Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

wcsncpy — kopiowanie z limitem znaków szerokich

wcsncpy kopiuje znaki wchar_t, dopełniając krótki wynik zerami, lecz nie gwarantuje zakończenia napisu.

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

Składnia

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

wcsncpy z <wchar.h> kopiuje z s2 do s1. Limit n liczy elementy wchar_t, nie bajty. Funkcja zwraca s1.

Krótsze źródło powoduje dopełnienie L'\0' do dokładnie n zapisanych elementów. Jeśli pierwsze n elementów nie zawiera zera, wynik nie ma terminatora.

Cel musi mieścić n elementów; źródło musi być dostępne do pierwszego zera lub przez n elementów. Nakładanie kopiowanych obszarów powoduje niezdefiniowane zachowanie. Limit nie sprawdza pojemności celu.

Przykłady

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

Wynik

padding: 1 1
prefix: 1 1

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

Źródła