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.

CONFORME A¶

Esta función es una extensión GNU.

VÉASE TAMBIÉN¶

stpncpy(3), wcsncpy(3)