STRCPY

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 15 juin 2007
Index Menu principal

NOM

strcpy, strncpy - Copier une chaîne

SYNOPSIS

#include <string.h>

char *strcpy(char *dest, const char *src);

char *strncpy(char *dest, const char *src, size_t n);

DESCRIPTION

La fonction strcpy() copie la chaîne pointée par src (y compris l'octet nul « \0 » final) dans la chaîne pointée par dest. Les deux chaînes ne doivent pas se chevaucher. La chaîne dest doit être assez grande pour accueillir la copie.

La fonction strncpy() est identique, sauf que seuls les n premiers octets de src sont copiés. Avertissement : s'il n'y a pas d'octet nul dans les n premiers octets de src, la chaîne résultante dans dest ne disposera pas d'octet nul final.

Dans le cas où la longueur de src est inférieure à n, la fin de dest sera remplie avec des octets nuls.

Une implémentation simple de strncpy() pourrait être :


char*
strncpy(char *dest, const char *src, size_t n){
    size_t i;

    for (i = 0 ; i < n && src[i] != aq\0aq ; i++)
        dest[i] = src[i];
    for ( ; i < n ; i++)
        dest[i] = aq\0aq;

    return dest;
}

VALEUR RENVOYÉE

Les fonctions strcpy() et strncpy() renvoient un pointeur sur la chaîne destination dest.

CONFORMITÉ

SVr4, BSD 4.3, C89, C99.

NOTES

Certains programmeurs considèrent strncpy() comme inefficace et propice aux erreurs. Si le programmeur sait (c'est-à-dire, en ajoutant du code pour le tester !) que la taille de dest est supérieure à la longueur de src, il peut utiliser strcpy().

S'il n'y a pas d'octet nul de terminaison dans les n premiers caractères de src, strncpy() produit dans dest une chaîne sans caractère nul final. Souvent, les programmeurs évitent cette erreur en forçant l'octet final comme suit :


strncpy(buf, str, n);
if (n > 0)
    buf[n - 1]= aq\0aq;

BOGUES

Si la chaîne destination de strcpy() n'est pas assez grande (c'est-à-dire si le programmeur est stupide ou paresseux et n'a pas vérifié la taille avant la copie), tout peut arriver ! Le débordement de chaîne de caractères de longueur fixée est l'une des techniques préférées des pirates.

VOIR AUSSI

bcopy(3), memccpy(3), memcpy(3), memmove(3), wcscpy(3), wcsncpy(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 9 novembre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 strcpy ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008