Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

strncpy — kopírování s doplněním nulami

strncpy zapíše n bajtů a kratší vstup doplní nulami. Nezaručuje, že výsledek bude ukončen znakem '\0'.

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

Syntaxe

#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 vrací s1. Pokud před dosažením limitu n narazí na '\0', doplní výsledek nulami přesně na n bajtů.

Pokud prvních n bajtů zdroje neobsahuje '\0', výsledek nemá ukončovací znak. n automaticky nekontroluje kapacitu: cílová oblast musí pojmout n bajtů a zdroj musí být čitelný až po první '\0' nebo po dobu n bajtů. Překrývající se oblasti způsobují nedefinované chování.

Nepředávejte neukončený výsledek neomezenému %s. Příklad ukazuje doplnění a zkrácení; %.*s omezuje čtení z truncated.

Pří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ýsledek

padded: Hi; zero padding: 1 1 1
truncated: Hel

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.

Zdroje