NOM

       stpcpy - Copier une chaîne en renvoyant un pointeur sur sa fin

SYNOPSIS

       #include <string.h>

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

   Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

       stpcpy() :
           Depuis la glibc 2.10 :
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Avant la glibc 2.10 :
               _GNU_SOURCE

DESCRIPTION

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

VALEUR RENVOYÉE

       stpcpy() renvoie un pointeur sur la fin de la chaîne dest (c'est-à dire l'adresse du caractère nul final)
       au lieu du début.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction stpcpy() est sûre dans un contexte multithread.

CONFORMITÉ

       Cette  fonction  a  été ajoutée à POSIX.1-2008. Avant cela, elle ne faisait partie ni de la norme C ni de
       POSIX.1, et n'était pas spécifique  UNIX,  mais  n'était  pas  non  plus  une  extension  GNU.  Peut-être
       venait-elle de l'environnement MS-DOS. Elle est également présente sur les BSDs.

BOGUES

       Cette fonction peut écraser des octets en dehors de dest.

EXEMPLE

       Par  exemple,  ce  programme utilise stpcpy() pour concaténer foo et bar produisant ainsi foobar, qui est
       alors affichée.

       #define _GNU_SOURCE
       #include <string.h>
       #include <stdio.h>

       int
       main(void)
       {
           char buffer[20];
           char *to = buffer;

           to = stpcpy(to, "foo");
           to = stpcpy(to, "bar");
           printf("%s\n", buffer);
       }

VOIR AUSSI

       bcopy(3), memccpy(3), memcpy(3), memmove(3), stpncpy(3), strcpy(3), string(3), wcpcpy(3)

COLOPHON

       Cette page fait partie de la publication 3.65 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

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe       Blaess       <http://www.blaess.fr/christophe/>      (1996-2003),      Alain      Portal
       <http://manpagesfr.free.fr/> (2003-2006). Nicolas François  et  l'équipe  francophone  de  traduction  de
       Debian (2006-2009).

       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> ».

GNU                                              13 janvier 2014                                       STPCPY(3)