wcpncpy − Copier une chaîne de caractères larges de longueur donnée, en renvoyant un pointeur sur sa fin.

#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)

Christophe Blaess, 2000.