STPNCPY(3)

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

SYNOPSIS
#define _GNU_SOURCE
#include <string.h>

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

DESCRIPTION
La fonction stpncpy() copie au plus n caractères depuis la chaîne pointée par src, y compris l'octet 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 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 d'octet nul final, dest + n.

CONFORMITÉ
Cette fonction est une extension GNU.

VOIR AUSSI
strncpy(3), wcpncpy(3), feature_test_macros(7)

TRADUCTION

Ce document est une traduction réalisée par Thierry Vignaud <tvignaud AT mandriva DOT com> en 1999 et révisée le 17 juillet 2008.

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