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

NOME

       catopen, catclose - abre/fecha um catalogo 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,C~AO

       catopen()  abre  um  catalogo  de  mensagens  e retorna um descritor de
       catalogo.  name especifica o nome do catalogo a ser  aberto.   Se  name
       designar  um  caminho  absoluto,  name  sera  o  path do catalogo. Caso
       contrario, sera usado o valor de NLSPATH , sendo name  substituido  por
       %N  (ver  locale(7)).   Se  NLSPATH  nao  existir  no ambiente, ou se o
       catalogo de mensagens nao puder ser aberto com qualquer  dos  paths  em
       NLSPATH, o arquivo sera 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 ultimo dos caminhos acima, name designa o
       nome do catalogo.

       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 necessario do catalogo, e o segundo faz com que  o
       catalogo seja colocado integralmente na memoria.

       catclose()   fecha   o  catalogo  designado  por  catalog,  invalidando
       quaisquer referencias posteriores ao catalogo designado por catalog.

VALORES RETORNADOS

       catopen() retorna um descritor de catalogo do  tipo  nl_catd  se  tiver
       exito.  Caso contrario, retorna -1.

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

OBSERVA,C~OES

       Estas  funcoes  so estao disponiveis no libc.so.4.4.4c ou posterior. No
       linux, o descritor de catalogo l_catd e na verdade uma area alocada com
       mmap() e nao um descritor de arquivo, o que permite compartilhamento de
       catalogos.

VER TAMB'EM

       catgets(3), setlocale(3)

                               30 November 1993                     CATOPEN(3)