NOMBRE¶
wcpncpy - copia una cadena de caracteres anchos de tamaño fijo,
devolviendo un puntero a su final
SINOPSIS¶
#include <wchar.h>
wchar_t *wcpncpy (wchar_t *dest, const wchar_t *src, size_t n);
DESCRIPCIÓN¶
La función
wcpncpy es el equivalente de caracteres anchos de la
función
stpncpy. Copia, a lo sumo
n caracteres anchos de
la cadena de caracteres anchos apuntada por
src, incluyendo el
carácter de terminación L'\0', en la cadena apuntada por
dest. Se escriben exactamente
n caracteres en
dest. Si la
longitud
wcslen(src) es menor que
n, el resto de caracteres
anchos apuntados por
dest se rellenan con caracteres L'\0'. Si la
longitud
wcslen(src) es mayor o igual que
n, la cadena apuntada
por
dest no estará terminada en L'\0'.
Las cadenas no se pueden solapar.
El programador tiene que asegurarse de que hay espacio para, al menos,
n
caracteres anchos en
dest.
VALOR DEVUELTO¶
wcpncpy devuelve un puntero al último carácter ancho
escrito, esto es, final de la cadena de caracteres anchos
dest + n - 1.
Esta función es una extensión GNU.
VÉASE TAMBIÉN¶
stpncpy(3),
wcsncpy(3)