Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

wcsncpy — omejeno kopiranje širokih znakov

wcsncpy kopira elemente wchar_t in krajše rezultate dopolni z ničlami, vendar ne zagotavlja zaključka niza.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

wcsncpy iz <wchar.h> kopira iz s2 v s1. Omejitev n šteje elemente wchar_t, ne bajtov. Funkcija vrne s1.

Če je vir krajši, se dodajajo elementi L'\0', dokler ni zapisanih natanko n elementov. Če prvih n elementov ne vsebuje ničle, rezultat ni zaključen.

Cilj mora imeti prostor za n elementov; vir mora biti berljiv do prve ničle ali za n elementov. Prekrivanje kopiranih območij povzroči nedefinirano vedenje. Omejitev ne preverja zmogljivosti cilja.

Primeri

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

Rezultat

padding: 1 1
prefix: 1 1

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri