STRCPY(3)

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] != '\0' ; i++)
        dest[i] = src[i];
    for ( ; i < n ; i++)
        dest[i] = '\0';
    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]= '\0';

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.