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)