NOM

       stpncpy - Copier une chaîne de taille fixe et pointer sur sa fin

SYNOPSIS

       #include <string.h>

       char *stpncpy(char *dest, const char *src, size_t n);

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

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

DESCRIPTION

       La fonction stpncpy() copie au plus n caractères depuis  la  chaîne  pointée  par  src,  y
       compris  l'octet  nul  (« \0 »)  final  dans  le  tableau  pointé  par  dest. Exactement n
       caractères sont écrits dans dest. Si la longueur strlen(src) est plus petite  que  n,  les
       caractères restant dans le tableau pointé par dest sont remplis d'octets nuls (« \0 »). Si
       la longueur strlen(src) est supérieure ou égale à n, la chaîne pointée par  dest  ne  sera
       pas terminée par un octet nul final.

       Les chaînes ne doivent pas se chevaucher.

       Le  programmeur doit s'assurer qu'il a réservé assez de mémoire pour au moins n caractères
       dans dest.

VALEUR RENVOYÉE

       stpncpy() renvoie un pointeur sur l'octet nul final dans dest,  ou  si  dest  n'a  pas  de
       caractère nul final, dest+n.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction stpncpy() est sûre dans un contexte multithread.

CONFORMITÉ

       Cette fonction a été ajoutée à POSIX.1-2008. Avant cela, c'était une extension GNU.

VOIR AUSSI

       strncpy(3), wcpncpy(3)

COLOPHON

       Cette  page  fait partie de la publication 3.65 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/>.

       Thierry Vignaud (2002), Alain Portal <http://manpagesfr.free.fr/> (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> ».