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

#define _GNU_SOURCE
#include <string.h>

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

La fonction stpncpy() copie au plus n caractères depuis la chaîne pointée par src, y compris le caractère final « \0 » dans le tableau pointé par dest. n caractères exactement 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 mis à zéro. Si la longueur strlen(src) est plus grande que n, la chaîne pointée par dest ne sera pas terminée par un caractère nul final.

Les chaînes ne doivent pas se recouvrir.

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

stpncpy() renvoie un pointeur sur le caractère nul final dans dest, ou si dest n’est pas un caractère nul final, dest + n.

Cette fonction est une extension GNU.

strncpy(3), wcpncpy(3)

Ce document est une traduction réalisée par Thierry Vignaud <tvignaud AT mandriva DOT com> en 1999 et révisée le 21 juillet 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=en man 3 stpncpy ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.