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

CKTIS / C

strndup — copie à longueur limitée allouée dynamiquement

strndup crée une chaîne indépendante à partir d’au plus size premiers caractères d’un tableau et ajoute un terminateur nul. Vérifiez le résultat et libérez-le avec free.

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

Syntaxe

#include <string.h>
char *strndup(const char *s, size_t size);

strndup, déclarée dans <string.h>, crée une copie dans un espace mémoire alloué comme par malloc. Elle copie au plus size caractères depuis s, en s’arrêtant plus tôt à \0. Le résultat se termine toujours par \0 ; la limite n’inclut pas ce terminateur.

La source n’a pas besoin d’être terminée par un caractère nul si elle contient au moins size caractères lisibles. Sinon, un terminateur doit se trouver dans la zone accessible avant que la limite soit atteinte. La limite ne rend pas valide un pointeur incorrect. Ne supposez pas que le résultat a une capacité de size + 1 si la copie s’est arrêtée plus tôt.

En cas d’échec de l’allocation, la fonction renvoie NULL. Vérifiez le résultat avant de l’utiliser et libérez une copie obtenue avec succès à l’aide de free. Contrairement à strdup, strndup limite le nombre de caractères copiés.

Cette fonction fait partie de C23. L’option du compilateur utilisée dans le dépôt ne garantit pas sa disponibilité dans l’environnement d’exécution de production ; des en-têtes adaptés et la prise en charge par la bibliothèque sont également nécessaires. L’exemple utilise volontairement un tableau sans terminateur.

Exemples

#define _POSIX_C_SOURCE 200809L
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(void)
{
    const char data[] = {'h', 'e', 'l', 'l', 'o'};
    char *copy = strndup(data, 3);
    if (copy == NULL) return EXIT_FAILURE;
    puts(copy);
    free(copy);
    return EXIT_SUCCESS;
}

Résultat

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