Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strncpy — kopiowanie z dopełnianiem zerami

strncpy zapisuje n bajtów, dopełniając krótkie dane zerami. Nie gwarantuje zakończenia wyniku znakiem '\0'.

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

Składnia

#include <string.h>
char *strncpy(char * restrict s1, const char * restrict s2, size_t n);

strncpy z <string.h> kopiuje z s2 do s1 i zwraca s1. Gdy napotka '\0' przed limitem n, dopełnia wynik zerami do dokładnie n bajtów.

Jeżeli pierwsze n bajtów źródła nie zawiera '\0', wynik nie ma terminatora. n nie jest automatycznym sprawdzeniem pojemności: cel musi mieścić n bajtów, a źródło musi być czytelne do pierwszego '\0' lub przez n bajtów. Nakładanie obszarów powoduje niezdefiniowane zachowanie.

Nie przekazuj niezakończonego wyniku do %s bez ograniczenia. Przykład pokazuje dopełnianie oraz obcięcie; %.*s ogranicza odczyt z truncated.

Przykłady

#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;
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła