NOM

       stpncpy,  strncpy  —  Mettre à zéro un tampon de taille fixe et copier une chaîne dans une
       séquence de caractères avec troncature et mettre à zéro le reste

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <string.h>

       char *stpncpy(char dst[restrict .sz], const char *restrict src,
                      size_t sz);
       char *strncpy(char dst[restrict .sz], const char *restrict src,
                      size_t sz);

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

       stpncpy() :
           Depuis la glibc 2.10 :
               _POSIX_C_SOURCE >= 200809L
           Avant la glibc 2.10 :
               _GNU_SOURCE

DESCRIPTION

       Ces fonctions copient la chaîne pointée par src dans une séquence de caractères remplie de
       caractères NULL à l'emplacement du tampon de largeur fixe pointé par dst. Si le tampon  de
       destination, de taille limitée, n'est pas assez grand pour contenir la copie, la chaîne de
       caractères résultante est  tronquée.  Pour  la  différences  entres  les  deux  fonctions,
       consultez VALEUR RENVOYÉE.

       Une implémentation de ces fonctions pourrait être cela :

           char *
           stpncpy(char *restrict dst, const char *restrict src, size_t sz)
           {
               bzero(dst, sz);
               return mempcpy(dst, src, strnlen(src, sz));
           }

           char *
           strncpy(char *restrict dst, const char *restrict src, size_t sz)
           {
               stpncpy(dst, src, sz);
               return dst;
           }

VALEUR RENVOYÉE

       stpncpy()
              renvoie  un  pointeur  sur  un octet après le dernier caractère dans la séquence de
              caractères de destination.

       strncpy()
              renvoie dst.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │Interface                                               │ Attribut             │ Valeur  │
       ├────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │stpncpy(), strncpy()                                    │ Sécurité des threads │ MT-Safe │
       └────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       stpncpy()
              POSIX.1-2008.

       strncpy()
              POSIX.1-2001, POSIX.1-2008, C99, SVr4, 4.3BSD.

AVERTISSEMENTS

       Le nom de ces fonctions prête à  confusion.  Ces  fonctions  produisent  une  séquence  de
       caractères complétée par des caractères NULL, pas une chaîne (voir string_copying(7)).

       Il est impossible de distinguer une troncature comme résultat de l'appel d'une séquence de
       caractères qui s'ajuste au tampon de destination ; la troncature  peut  être  détectée  en
       comparant la longueur de la chaîne d'entrée à celle du tampon de destination.

       Si  vous  comptez utiliser cette fonction dans une chaîne d'appels, il pourrait être utile
       de développer une fonction similaire qui accepte un pointeur sur la fin (un octet après le
       dernier élément) du tampon de destination plutôt qu'en donnant sa taille.

EXEMPLES

       #include <err.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <string.h>

       int
       main(void)
       {
           char    *p;
           char    buf1[20];
           char    buf2[20];
           size_t  len;

           if (sizeof(buf1) < strlen("Hello world!"))
               warnx("stpncpy: truncating character sequence");
           p = stpncpy(buf1, "Hello world!", sizeof(buf1));
           len = p - buf1;

           printf("[len = %zu]: ", len);
           printf("%.*s\n", (int) len, buf1);  // "Hello world!"

           if (sizeof(buf2) < strlen("Hello world!"))
               warnx("strncpy: truncating character sequence");
           strncpy(buf2, "Hello world!", sizeof(buf2));
           len = strnlen(buf2, sizeof(buf2));

           printf("[len = %zu]: ", len);
           printf("%.*s\n", (int) len, buf2);  // "Hello world!"

           exit(EXIT_SUCCESS);
       }

VOIR AUSSI

       wcpncpy(3), string_copying(7)

TRADUCTION

       La  traduction  française  de  cette  page  de  manuel  a  été créée par Christophe Blaess
       <https://www.blaess.fr/christophe/>, Stéphan  Rafin  <stephan.rafin@laposte.net>,  Thierry
       Vignaud  <tvignaud@mandriva.com>,  François Micaux, Alain Portal <aportal@univ-montp2.fr>,
       Jean-Philippe   Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)    <jean-
       luc.coulon@wanadoo.fr>,    Julien    Cristau    <jcristau@debian.org>,    Thomas   Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau  <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
       Barbier  <barbier@debian.org>,  David  Prévot   <david@tilapin.org>,   Frédéric   Hantrais
       <fhantrais@gmail.com>,  Grégoire  Scano  <gregoire.scano@malloc.fr>  et Jean-Pierre Giraud
       <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.