CKTIS / C
strncpy — kopírovanie s doplnením nulami
strncpy zapíše n bajtov a kratší vstup doplní nulami. Nezaručuje, že výsledok bude ukončený znakom '\0'.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strncpy(char * restrict s1, const char * restrict s2, size_t n);strncpy deklarovaná v <string.h> kopíruje z s2 do s1 a vracia s1. Ak pred dosiahnutím limitu n narazí na '\0', doplní výsledok nulami presne na n bajtov.
Ak prvých n bajtov zdroja neobsahuje '\0', výsledok nemá ukončovací znak. n automaticky nekontroluje kapacitu: cieľová oblasť musí pojať n bajtov a zdroj musí byť čitateľný až po prvé '\0' alebo počas n bajtov. Prekrývajúce sa oblasti spôsobujú nedefinované správanie.
Nepredávajte neukončený výsledok neobmedzenému %s. Príklad ukazuje doplnenie a skrátenie; %.*s obmedzuje čítanie z truncated.
Príklady
#include <stdio.h>
#include <string.h>
int main(void)
{
char padded[5];
char truncated[3];
strncpy(padded, "Hi", sizeof padded);
strncpy(truncated, "Hello", sizeof truncated);
printf("padded: %s; zero padding: %d %d %d\n",
padded, padded[2] == '\0', padded[3] == '\0',
padded[4] == '\0');
printf("truncated: %.*s\n", (int)sizeof truncated, truncated);
return 0;
}
Výsledok
padded: Hi; zero padding: 1 1 1 truncated: Hel
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.