.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 Mitchum DSouza .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Thu Dec 13 22:51:19 2001 by Martin Schulze .\" Modified 2001-12-14 aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH catopen 3 "31 outubro 2023" "Linux man\-pages 6.06" .SH NOME catopen, catclose \- abre/fecha um catálogo de mensagens .SH BIBLIOTECA Biblioteca C Padrão (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSE .nf \fB#include \fP .P \fBnl_catd catopen(const char *\fP\fInome\fP\fB, int \fP\fIsinalizador\fP\fB);\fP \fBint catclose(nl_catd \fP\fIcatálogo\fP\fB);\fP .fi .SH DESCRIÇÃO A função \fBcatopen\fP() abre um catálogo de mensagens e retorna um descritor de catálogo. O descritor permanece válido até \fBcatclose\fP() ou \fBexecve\fP(2). Se um descritor de arquivo for usado para implementar descritores de catálogo, o sinalizador \fBFD_CLOEXEC\fP será definido. .P O argumento \fInome\fP especifica o nome do catálogo de mensagens a ser aberto. Se \fInome\fP especifica um caminho absoluto (ou seja, contém um \[aq]/\[aq]), então \fInome\fP especifica um nome de caminho para o catálogo de mensagens. Caso contrário, a variável de ambiente \fBNLSPATH\fP será usada com \fInome\fP substituído por \fB%N\fP (consulte \fBlocale\fP(7)). Não é especificado se \fBNLSPATH\fP será usado quando o processo tiver privilégios de root. Se \fBNLSPATH\fP 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 \fBLC_MESSAGES\fP quando o argumento \fIsinalizador\fP for \fBNL_CAT_LOCALE\fP e da variável de ambiente \fBLANG\fP quando o argumento \fIsinalizador\fP for 0. Alterando o \fBLC_MESSAGES \fP parte do código do idioma pode invalidar descritores de catálogo abertos. .P O argumento \fIsinalizador\fP para \fBcatopen\fP() é usado para indicar a fonte da linguagem a ser usada. Se estiver definido como \fBNL_CAT_LOCALE\fP, então usará a configuração de localidade atual para \fBLC_MESSAGES\fP. Caso contrário, usará a variável de ambiente \fBLANG\fP. .P A função \fBcatclose\fP() fecha o catálogo de mensagens identificado por \fIcatálogo\fP. Ela invalida quaisquer referências subsequentes ao catálogo de mensagens definido por \fIcatálogo\fP. .SH "VALOR DE RETORNO" A função \fBcatopen\fP() retorna um descritor de catálogo de mensagens do tipo \fInl_catd\fP em caso de sucesso. Em caso de falha, ele retorna \fI(nl_catd)\~\-1\fP e define \fIerrno\fP para indicar o erro. Os possíveis valores de erro incluem todos os valores possíveis para a chamada \fBopen\fP(2). .P A função \fBcatclose\fP() retorna 0 se tiver êxito, ou \-1 se falhar. .SH AMBIENTE .TP \fBLC_MESSAGES\fP Pode ser a fonte da configuração de localidade \fBLC_MESSAGES\fP e, portanto, determinar o idioma a ser usado se \fIsinalizador\fP estiver definido como \fBNL_CAT_LOCALE\fP. .TP \fBLANG\fP O idioma a ser usado se \fIsinalizador\fP for 0. .SH ATRIBUTOS Para uma explicação dos termos usados nesta seção, consulte \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Atributo Valor T{ .na .nh \fBcatopen\fP() T} Thread safety Ambiente MT\-Safe T{ .na .nh \fBcatclose\fP() T} Thread safety MT\-Safe .TE .SH VERSÕES .\" (Compare .\" .B MCLoadAll .\" below.) .\" .SS Linux notes .\" These functions are available for Linux since libc 4.4.4c. .\" In the case of linux libc4 and libc5, the catalog descriptor .\" .I nl_catd .\" is a .\" .BR mmap (2)'ed .\" area of memory and not a file descriptor. .\" The .\" .I flag .\" argument to .\" .BR catopen () .\" should be either .\" .B MCLoadBySet .\" (=0) or .\" .B MCLoadAll .\" (=1). .\" The former value indicates that a set from the catalog is to be .\" loaded when needed, whereas the latter causes the initial call to .\" .BR catopen () .\" to load the entire catalog into memory. .\" The default search path varies, but usually looks at a number of places below .\" .I /etc/locale .\" and .\" .IR /usr/lib/locale . A descrição acima é a descrição POSIX.1. O valor de glibc para \fBNL_CAT_LOCALE\fP é 1. O caminho padrão varia, mas geralmente olha para vários locais abaixo de \fI/usr/share/locale\fP. .SH PADRÕES POSIX.1\-2008. .SH HISTÓRICO .\" In XPG 1987, Vol. 3 it says: .\" .I "The flag argument of catopen is reserved for future use" .\" .IR "and should be set to 0" . .\" .\" It is unclear what the source was for the constants .\" .B MCLoadBySet .\" and .\" .B MCLoadAll .\" (see below). POSIX.1\-2001. .SH "VEJA TAMBÉM" \fBcatgets\fP(3), \fBsetlocale\fP(3) .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Paulo César Mendes , André Luiz Fassone e Rafael Fontenelle . . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .