Linux Certif

Toute la documentation sur la certification Linux LPI

wcpncpy

NOM

wcpncpy - Copier une chaîne de caractères larges et indiquer sa fin

SYNOPSIS

 #define _GNU_SOURCE
 

 #include <wchar.h>
 
 wchar_t *wcpncpy (wchar_t *dest, const wchar_t *src, size_t n);
 

DESCRIPTION

La fonction wcpncpy() est l'équivalent, pour les caractères larges, de la fonction stpncpy(3). Elle copie au plus n caractères larges depuis la chaîne pointée par src, y compris le caractère L'\0' final, vers la chaîne pointée par dest. n caractères exactement seront écrits dans dest. Si la longueur wcslen(src) est inférieure à n, les caractères restants dans la table pointée par dest sont remplis de caractères L'\0'. Si la longueur wcslen(src) est supérieure ou égale à n, la chaîne pointée par dest ne sera pas terminée par un L'\0'.

Les chaînes ne doivent pas se chevaucher.

Il est de la responsabilité du programmeur de s'assurer qu'il y a assez de place pour au moins n caractères larges dans dest.

VALEUR RENVOYÉE

wcpncpy() renvoie un pointeur sur le dernier caractère écrit, c'est-à-dire dest + n - 1.

CONFORMITÉ

Cette fonction est une extension GNU.

VOIR AUSSI

stpncpy(3), wcsncpy(3), feature_test_macros(7)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 28 août 2000 et révisée le 19 novembre 2007.

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