Provided by: manpages-pt-dev_20040726-2_all bug

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)