ICONV_OPEN(3)

NOME
iconv_open - aloca descritor para conversão de conjunto de caracteres

SINÓPSE
#include <iconv.h>

iconv_t iconv_open (const char* paracodigo, const char* decodigo);

DESCRIÇÃO
A função iconv_open aloca um descritor de conversão adequado para converter seqüências de byte da codificação de caracteres decodigo para a codificação de caracteres paracodigo.

Os valores permitidos para decodigo e paracodigo e as combinações suportadas são dependentes de sistema. Para a biblioteca C GNU, os valores permitidos são listados pelo comando iconv --list, e todas as combinações dos valores listados são suportadas.

O descritor de conversão resultante pode ser usado com iconv qualquer número de vezes. Ele permanece válido até ser desalocado pelo uso de iconv_close.

Um descritor de conversão contém um estado de conversão. Depois da criação pelo uso de iconv_open, o estado está no estado inicial. Usar iconv modifica o estado de conversão do descritor. (Isso implica que um descritor de conversão não pode ser usado em múltiplas threads simultaneamente.) Para trazer o estado de volta ao estado inicial, use iconv com NULL como argumento inbuf.

VALORES RETORNADOS
A função iconv_open retorna um descritor de conversão novo. Em caso de erro, ela define errno e retorna (iconv_t)(-1).

ERROS
O seguinte erro pode ocorrer, entre outros:

EINVAL
    A conversão de decodigo para paracodigo não é suportada pela implementação.

DE ACORDO COM
UNIX98.

VEJA TAMBÉM
iconv(3), iconv_close(3), iconv(1).

TRADUZIDO POR LDP-BR em 10/06/2001.

  Tradução:
Marcelo M. de Abreu <mmabreu@terra.com.br>

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