NOME

       catopen, catclose - abre/fecha um catálogo de mensagens

SINOPSE

       #include <features.h>
       #include <nl_types.h>

       nl_catd catopen(name, flag)
       char *name;
       int flag;

       void catclose(catalog)
       nl_catd catalog;

DESCRIÇÃO

       catopen()  abre  um  catálogo  de  mensagens  e  retorna  um  descritor de catálogo.  name
       especifica o nome do catálogo a ser aberto.  Se name designar um  caminho  absoluto,  name
       será  o  path  do  catálogo.  Caso  contrário,  será usado o valor de NLSPATH , sendo name
       substituido por %N (ver locale(7)).  Se NLSPATH não existir no ambiente, ou se o  catálogo
       de  mensagens  não  puder  ser  aberto  com  qualquer dos paths em NLSPATH, o arquivo será
       procurado nos seguintes locais (nesta ordem)

              /etc/locale/LC_MESSAGES
              /usr/lib/locale/LC_MESSAGES
              /usr/lib/locale/name/LC_MESSAGES

       Em todos os casos, LC_MESSAGES designa o valor atual da  categoria  LC_MESSAGES  designada
       por  uma  chamada  anterior  a setlocale(), e tem como default o locale "C". No último dos
       caminhos acima, name designa o nome do catálogo.

       O argumento flag indica o tipo de carregamento, que pode ser MCLoadBySet ou MCLoadAll.   O
       primeiro valor faz com que seja carregado apenas o subconjunto necessário do catálogo, e o
       segundo faz com que o catálogo seja colocado integralmente na memória.

       catclose() fecha o catálogo  designado  por  catalog,  invalidando  quaisquer  referências
       posteriores ao catálogo designado por catalog.

VALORES RETORNADOS

       catopen()  retorna  um  descritor  de  catálogo  do  tipo  nl_catd  se  tiver êxito.  Caso
       contrário, retorna -1.

       catclose() retorna 0 se tiver êxito, ou -1 se falhar.

OBSERVAÇÕES

       Estas funções só estão disponíveis no libc.so.4.4.4c ou posterior. No linux,  o  descritor
       de catálogo l_catd é na verdade uma área alocada com mmap() e não um descritor de arquivo,
       o que permite compartilhamento de catálogos.

VER TAMBÉM

       catgets(3), setlocale(3)

                                         30 November 1993                              CATOPEN(3)