Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strncpy — copia con riempimento di zeri

strncpy scrive n byte e riempie con zeri gli input più brevi. Non garantisce che il risultato termini con '\0'.

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

Sintassi

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

strncpy, dichiarata in <string.h>, copia da s2 a s1 e restituisce s1. Se incontra '\0' prima del limite n, riempie il risultato con zeri fino a esattamente n byte.

Se i primi n byte della sorgente non contengono '\0', il risultato è privo di terminatore. n non controlla automaticamente la capacità: la destinazione deve poter contenere n byte e la sorgente deve essere leggibile fino al primo '\0' oppure per n byte. La sovrapposizione delle aree causa un comportamento indefinito.

Non passare un risultato non terminato a %s senza un limite. L’esempio mostra il riempimento e il troncamento; %.*s limita la lettura da truncated.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti