CKTIS / C
wcsncpy — ograničeno kopiranje širokih znakova
wcsncpy kopira elemente wchar_t i kraće rezultate dopunjava nulama, ali ne jamči završetak niza.
Verzija: 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 u s1. Ograničenje n broji elemente wchar_t, a ne bajtove. Funkcija vraća s1.
Ako je izvor kraći, dodaju se elementi L'\0' dok se ne upiše točno n elemenata. Ako prvih n elemenata ne sadrži nulu, rezultat nije završen.
Odredište mora imati mjesta za n elemenata; izvor mora biti čitljiv do prve nule ili tijekom n elemenata. Preklapanje kopiranih područja uzrokuje nedefinirano ponašanje. Ograničenje ne provjerava kapacitet odredišta.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.