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 <tvi‐
       gnaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe  Guérard  <fe‐
       vrier@tigreraye.org>,  Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@de‐
       bian.org>,  Thomas  Huriaux  <thomas.huriaux@gmail.com>,   Nicolas   François   <nicolas.francois@centra‐
       liens.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  <fhan‐
       trais@gmail.com>,  Grégoire  Scano  <gregoire.scano@malloc.fr>  et  Jean-Pierre  Giraud   <jean-pierregi‐
       raud@neuf.fr>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 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 à  de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                    26 janvier 2023                                      stpncpy(3)