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.