Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

strncpy — copie avec remplissage par des zéros

strncpy écrit n octets et complète les données plus courtes par des octets nuls. Elle ne garantit pas que le résultat se termine par '\0'.

Version : 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, déclarée dans <string.h>, copie de s2 vers s1 et renvoie s1. Si elle rencontre '\0' avant la limite n, elle complète le résultat avec des octets nuls jusqu’à exactement n octets.

Si les n premiers octets de la source ne contiennent pas '\0', le résultat n’a pas de terminateur. n ne vérifie pas automatiquement la capacité : la destination doit pouvoir contenir n octets, et la source doit être lisible jusqu’à son premier '\0' ou sur n octets. Le chevauchement des zones entraîne un comportement indéfini.

Ne passez pas un résultat sans terminateur à %s sans limite. L’exemple illustre le remplissage et la troncature ; %.*s limite la lecture de truncated.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources