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