Provided by: manpages-fr-dev_3.17.1-1_all bug

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 le
       caractère 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 qu’au plus n  octets  de  src
       sont  copiés.  Attention :  s’il  n’y a pas de caractère nul dans les n
       premiers octets de src, la chaîne résultante dans dest ne disposera pas
       de caractère nul final.

       Si  la  longueur de src est inférieure à n, strncpy() remplit la fin de
       dest avec des caractères 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  effectuer  le  test !)  que la taille de dest est supérieure à la
       longueur de src, alors strcpy() peut être utilisée.

       S’il n’y a pas d’octet nul de fin dans les  n  premiers  caractères  de
       src,   strncpy()  produit  une  chaîne  non  terminée  dans  dest.  Les
       programmeurs évitent souvent cette erreur en forçant la fin  de  chaîne
       de cette façon :

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

BOGUES

       Si  la  chaîne  de  destination  d’un  strcpy()  n’est pas suffisamment
       grande, n’importe quoi peut survenir. Un dépassement de tampon pour une
       chaîne de taille fixe est la technique favorite de pirates pour prendre
       le contrôle d’une machine. À chaque fois qu’un programme lit  ou  copie
       des  données dans un tampon, le programme doit d’abord vérifier qu’il y
       a suffisamment de place. Ça peut ne pas être nécessaire si vous  pouvez
       montrer  qu’un  dépassement est impossible, mais faites attention : les
       programmes changes au cours du temps, et ce qui était  impossible  peut
       devenir possible.

VOIR AUSSI

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

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.17 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       être       trouvées      à      l’adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement         gérées         par         Nicolas         François
       <nicolas.francois@centraliens.net>    et    l’équipe   francophone   de
       traduction de Debian.

       Veuillez  signaler  toute  erreur   de   traduction   en   écrivant   à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document
       en utilisant la commande « man -L C <section> <page_de_man> ».