stpcpy

Autres langues

Langue: fr

Version: 3 septembre 1995 (fedora - 25/11/07)

Section: 3 (Bibliothèques de fonctions)

NOM

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

SYNOPSIS

 #define _GNU_SOURCE
 
#include <string.h> char *stpcpy (char *dest, const char *src);

DESCRIPTION

La fonction stpcpy() 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, 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 de l'octet 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 de la norme C ni de POSIX.1, 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

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

TRADUCTION

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 stpcpy ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.