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

#define _GNU_SOURCE
#include <wchar.h>

wchar_t *wcpncpy (wchar_t *dest, const wchar_t *src, size_t n);

La fonction wcpncpy() est l’équivalent pour les caractères larges de la fonction stpncpy(). 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.

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

Cette fonction est une extension GNU.

stpncpy(3), wcsncpy(3)

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