stpcpy

Autres langues

Langue: fr

Version: 21 juillet 2003 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NOM

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

SYNOPSIS


#include <string.h>



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

DESCRIPTION

La fonction stpcpy() copie la chaine pointée par src (y compris le caractère `\0' final) dans la chaine pointée par dest. Les deux chaînes ne doivent pas se chevaucher, et 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.

EXEMPLE

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



   #include <string.h>



   int

   main (void)

   {

      char buffer [7];

      char *vers = buffer;

      vers = stpcpy (vers, "foo");

      vers = stpcpy (vers, "bar");

      printf ("%s\n", buffer);

   }

CONFORMITÉ

Cette fonction ne fait partie ni du standard ANSI ni de POSIX, elle n'est pas spécifique Unix, et n'est pas une extension GNU. Peut-être vient-elle de l'environnement MS-DOS...

VOIR AUSSI

strcpy(3), bcopy(3), memccpy(3), memcpy(3), memmove(3)

TRADUCTION

Christophe Blaess, 1996-2003.