NOME

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

BIBLIOTECA

       Biblioteca C Padrão (libc, -lc)

SINOPSE

       #include <nl_types.h>

       nl_catd catopen(const char *nome, int sinalizador);
       int catclose(nl_catd catálogo);

DESCRIÇÃO

       A  função  catopen()  abre  um  catálogo  de  mensagens  e  retorna um descritor de catálogo. O descritor
       permanece válido até catclose() ou execve(2). Se um descritor  de  arquivo  for  usado  para  implementar
       descritores de catálogo, o sinalizador FD_CLOEXEC será definido.

       O  argumento  nome especifica o nome do catálogo de mensagens a ser aberto. Se nome especifica um caminho
       absoluto (ou seja, contém um '/'), então nome especifica um nome de caminho para o catálogo de mensagens.
       Caso contrário, a variável de  ambiente  NLSPATH  será  usada  com  nome  substituído  por  %N  (consulte
       locale(7)).  Não  é  especificado  se  NLSPATH será usado quando o processo tiver privilégios de root. Se
       NLSPATH não existir no ambiente ou se um catálogo de  mensagens  não  puder  ser  aberto  em  nenhum  dos
       caminhos  especificados  por  ele, um caminho definido pela implementação será usado. Este último caminho
       padrão pode depender da configuração  de  localidade  LC_MESSAGES  quando  o  argumento  sinalizador  for
       NL_CAT_LOCALE  e  da  variável  de  ambiente  LANG  quando  o  argumento  sinalizador  for 0. Alterando o
       LC_MESSAGES  parte do código do idioma pode invalidar descritores de catálogo abertos.

       O argumento sinalizador para catopen() é usado para indicar a fonte da linguagem a ser usada. Se  estiver
       definido  como  NL_CAT_LOCALE,  então  usará  a  configuração  de localidade atual para LC_MESSAGES. Caso
       contrário, usará a variável de ambiente LANG.

       A função catclose() fecha o catálogo de mensagens  identificado  por  catálogo.  Ela  invalida  quaisquer
       referências subsequentes ao catálogo de mensagens definido por catálogo.

VALOR DE RETORNO

       A  função  catopen() retorna um descritor de catálogo de mensagens do tipo nl_catd em caso de sucesso. Em
       caso de falha, ele retorna (nl_catd) -1 e define errno para indicar o erro. Os possíveis valores de  erro
       incluem todos os valores possíveis para a chamada open(2).

       A função catclose() retorna 0 se tiver êxito, ou -1 se falhar.

AMBIENTE

       LC_MESSAGES
              Pode  ser a fonte da configuração de localidade LC_MESSAGES e, portanto, determinar o idioma a ser
              usado se sinalizador estiver definido como NL_CAT_LOCALE.

       LANG   O idioma a ser usado se sinalizador for 0.

ATRIBUTOS

       Para uma explicação dos termos usados nesta seção, consulte attributes(7).
       ┌────────────────────────────────────────────────────────────────────┬───────────────┬──────────────────┐
       │ Interface                                                          │ Atributo      │ Valor            │
       ├────────────────────────────────────────────────────────────────────┼───────────────┼──────────────────┤
       │ catopen()                                                          │ Thread safety │ Ambiente MT-Safe │
       ├────────────────────────────────────────────────────────────────────┼───────────────┼──────────────────┤
       │ catclose()                                                         │ Thread safety │ MT-Safe          │
       └────────────────────────────────────────────────────────────────────┴───────────────┴──────────────────┘

VERSÕES

       A descrição acima é a descrição POSIX.1. O valor de glibc para NL_CAT_LOCALE é 1. O caminho padrão varia,
       mas geralmente olha para vários locais abaixo de /usr/share/locale.

PADRÕES

       POSIX.1-2008.

HISTÓRICO

       POSIX.1-2001.

VEJA TAMBÉM

       catgets(3), setlocale(3)

TRADUÇÃO

       A  tradução  para  português  brasileiro  desta  página  man  foi   criada   por   Paulo   César   Mendes
       <drpc@ism.com.br>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

       Esta  tradução  é  uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as
       condições de direitos autorais.  Nenhuma responsabilidade é aceita.

       Se você encontrar algum erro na tradução  desta  página  de  manual,  envie  um  e-mail  para  a lista de
       discussão de tradutores.

Linux man-pages 6.9.1                              2 maio 2024                                        catopen(3)