catopen(3) Library Functions Manual catopen(3) NOME catopen, catclose - abre/fecha um catalogo de mensagens BIBLIOTECA Biblioteca C Padrao (libc, -lc) SINOPSE #include nl_catd catopen(const char *nome, int sinalizador); int catclose(nl_catd catalogo); DESCRICAO A funcao catopen() abre um catalogo de mensagens e retorna um descritor de catalogo. O descritor permanece valido ate catclose() ou execve(2). Se um descritor de arquivo for usado para implementar descritores de catalogo, o sinalizador FD_CLOEXEC sera definido. O argumento nome especifica o nome do catalogo de mensagens a ser aberto. Se nome especifica um caminho absoluto (ou seja, contem um '/'), entao nome especifica um nome de caminho para o catalogo de mensagens. Caso contrario, a variavel de ambiente NLSPATH sera usada com nome substituido por %N (consulte locale(7)). Nao e especificado se NLSPATH sera usado quando o processo tiver privilegios de root. Se NLSPATH nao existir no ambiente ou se um catalogo de mensagens nao puder ser aberto em nenhum dos caminhos especificados por ele, um caminho definido pela implementacao sera usado. Este ultimo caminho padrao pode depender da configuracao de localidade LC_MESSAGES quando o argumento sinalizador for NL_CAT_LOCALE e da variavel de ambiente LANG quando o argumento sinalizador for 0. Alterando o LC_MESSAGES parte do codigo do idioma pode invalidar descritores de catalogo abertos. O argumento sinalizador para catopen() e usado para indicar a fonte da linguagem a ser usada. Se estiver definido como NL_CAT_LOCALE, entao usara a configuracao de localidade atual para LC_MESSAGES. Caso contrario, usara a variavel de ambiente LANG. A funcao catclose() fecha o catalogo de mensagens identificado por catalogo. Ela invalida quaisquer referencias subsequentes ao catalogo de mensagens definido por catalogo. VALOR DE RETORNO A funcao catopen() retorna um descritor de catalogo 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 possiveis valores de erro incluem todos os valores possiveis para a chamada open(2). A funcao catclose() retorna 0 se tiver exito, ou -1 se falhar. AMBIENTE LC_MESSAGES Pode ser a fonte da configuracao 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 explicacao dos termos usados nesta secao, consulte attributes(7). +-----------------------------------+---------------+------------------+ |Interface | Atributo | Valor | +-----------------------------------+---------------+------------------+ |catopen() | Thread safety | Ambiente MT-Safe | +-----------------------------------+---------------+------------------+ |catclose() | Thread safety | MT-Safe | +-----------------------------------+---------------+------------------+ VERSOES A descricao acima e a descricao POSIX.1. O valor de glibc para NL_CAT_LOCALE e 1. O caminho padrao varia, mas geralmente olha para varios locais abaixo de /usr/share/locale. PADROES POSIX.1-2008. HISTORICO POSIX.1-2001. VEJA TAMBEM catgets(3), setlocale(3) TRADUCAO A traducao para portugues brasileiro desta pagina man foi criada por Paulo Cesar Mendes , Andre Luiz Fassone e Rafael Fontenelle . Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 ou posterior para as condicoes de direitos autorais. Nenhuma responsabilidade e aceita. Se voce encontrar algum erro na traducao desta pagina de manual, envie um e-mail para a lista de discussao de tradutores . Linux man-pages 6.06 31 outubro 2023 catopen(3)