WCPNCPY(3)

NOME
wcpncpy - copia uma seqüencia de tamanho determinado de caracteres largos, retornando um ponteiro para o seu final

SINÓPSE
#include <wchar.h>

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

DESCRIÇÃO
A função wcpncpy é a equivalente para caracteres largos da função stpncpy. Copia no máximo n caracteres largos da seqüencia de caracteres largos apontada por src, incluindo o caractere de terminação L'\0', para o vetor apontado por dest. Exatamente n caracteres largos são escritos em dest. Se o tamanho de wcslen(src) é menor que n, os caracteres largos restantes no vetor apontado por dest são preenchidos com caracteres L'\0'. Se o tamanho de wcslen(src) é maior ou igual a n, a seqüencia apontada por dest não será terminada por L'\0'.

As seqüencias não podem se sobrepor.

O programador deve assegurar que há espaço para pelo menos n caracteres largos em dest.

VALORES RETORNADOS
wcpncpy retorna um ponteiro para os últimos caracteres largos escritos, isto é, dest + n - 1.

DE ACORDO COM
Esta função é uma extensão GNU.

VEJA TAMBÉM
stpncpy(3), wcsncpy(3).

TRADUZIDO POR LDP-BR em 25/08/2000.

  Tradução:
Marcelo D. Beckmann <marcelobeckmann@yahoo.com>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>