CKTIS / C
wcsncpy — omezené kopírování širokých znaků
wcsncpy kopíruje prvky wchar_t a kratší výsledky doplňuje nulami, nezaručuje však ukončení řetězce.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#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čítá prvky wchar_t, nikoli bajty. Funkce vrací s1.
Je-li zdroj kratší, doplňují se prvky L'\0', dokud není zapsáno přesně n prvků. Pokud prvních n prvků neobsahuje nulu, výsledek není ukončený.
Cíl musí pojmout n prvků; zdroj musí být čitelný až po první nulu nebo po dobu n prvků. Překrývající se oblasti kopírování způsobují nedefinované chování. Limit nekontroluje kapacitu cíle.
Pří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ýsledek
padding: 1 1 prefix: 1 1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.