KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strncpy — kopiëren met nullen als opvulling

strncpy schrijft n bytes en vult kortere invoer aan met nullen. Een resultaat dat eindigt op '\0' is niet gegarandeerd.

Versie: 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, gedeclareerd in <string.h>, kopieert van s2 naar s1 en geeft s1 terug. Als de functie vóór de limiet n een '\0' tegenkomt, vult ze het resultaat aan met nullen tot precies n bytes.

Als de eerste n bytes van de bron geen '\0' bevatten, heeft het resultaat geen terminator. n controleert de capaciteit niet automatisch: de bestemming moet n bytes kunnen bevatten en de bron moet leesbaar zijn tot de eerste '\0' of gedurende n bytes. Overlappende gebieden veroorzaken ongedefinieerd gedrag.

Geef een niet-afgesloten resultaat niet door aan onbeperkt %s. Het voorbeeld laat opvulling en afkapping zien; %.*s begrenst het lezen uit truncated.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen