strcpy, strncpy − Copier une chaîne.

#include <string.h>

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

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

La fonction strcpy() copie la chaîne pointée par src (y compris le caractère « \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. Ainsi, s’il n’y a pas d’octet nul dans les n premiers octets de src, la chaîne résultante 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.

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

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 verifié 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. Les caractères en excès peuvent en effet déborder dans une zone de code ou de pile, et être interprétés comme des instructions, qui seront exécutées avec l’UID du programme. Il s’agit d’un moyen classique d’obtenir un accès « root » avec les programmes Set−UID système.

SVr4, 4.3BSD, C89, C99.

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

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 14 août 2006.

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.