Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

wcsncpy — obmedzené kopírovanie širokých znakov

wcsncpy kopíruje prvky wchar_t a kratšie výsledky dopĺňa nulami, nezaručuje však ukončenie reťazca.

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

Syntax

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

wcsncpy z <wchar.h> kopíruje z s2 do s1. Limit n počíta prvky wchar_t, nie bajty. Funkcia vracia s1.

Ak je zdroj kratší, dopĺňajú sa prvky L'\0', kým sa nezapíše presne n prvkov. Ak prvých n prvkov neobsahuje nulu, výsledok nie je ukončený.

Cieľ musí pojať n prvkov; zdroj musí byť čitateľný až po prvú nulu alebo počas n prvkov. Prekrývajúce sa oblasti kopírovania spôsobujú nedefinované správanie. Limit nekontroluje kapacitu cieľa.

Príklady

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

Výsledok

padding: 1 1
prefix: 1 1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje