CKTIS / C
strncpy — kopiranje z dopolnjevanjem z ničlami
strncpy zapiše n bajtov in krajši vhod dopolni z ničlami. Ne zagotavlja, da se rezultat konča z znakom '\0'.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <string.h>
char *strncpy(char * restrict s1, const char * restrict s2, size_t n);strncpy, deklarirana v <string.h>, kopira iz s2 v s1 in vrne s1. Če pred omejitvijo n naleti na '\0', rezultat dopolni z ničlami do natanko n bajtov.
Če prvih n bajtov vira ne vsebuje '\0', rezultat nima zaključnega znaka. n ne preveri samodejno zmogljivosti: cilj mora sprejeti n bajtov, vir pa mora biti berljiv do prvega '\0' ali skozi n bajtov. Prekrivanje območij povzroči nedefinirano vedenje.
Ne podajajte rezultata brez zaključnega znaka neomejenemu %s. Primer prikazuje dopolnjevanje in krajšanje; %.*s omeji branje iz truncated.
Primeri
#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;
}
Rezultat
padded: Hi; zero padding: 1 1 1 truncated: Hel
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.