catopen, catclose - abre/cierra un catálogo de mensajes
Biblioteca Estándar C (
libc,
-lc)
#include <nl_types.h>
nl_catd catopen(const char *name, int flag);
int catclose(nl_catd catalog);
La función
catopen() abre un catálogo de mensajes y
devuelve un descriptor de catálogo. El descriptor permanece
válido hasta una llamada a
catclose() o
execve(2). Si un
descriptor de fichero es utilizado para implementar descriptores de
catálogo la bandera
FD_CLOEXEC es activada.
The argument
name specifies the name of the message catalog to be opened.
If
name specifies an absolute path (i.e., contains a '/'), then
name specifies a pathname for the message catalog. Otherwise, the
environment variable
NLSPATH is used with
name substituted for
%N (see
locale(7)). It is unspecified whether
NLSPATH
will be used when the process has root privileges. If
NLSPATH does not
exist in the environment, or if a message catalog cannot be opened in any of
the paths specified by it, then an implementation defined path is used. This
latter default path may depend on the
LC_MESSAGES locale setting when
the
flag argument is
NL_CAT_LOCALE and on the
LANG
environment variable when the
flag argument is 0. Changing the
LC_MESSAGES part of the locale may invalidate open catalog descriptors.
El argumento
flag de
catopen() se emplea para indicar el origen
para el idioma a utilizar. Si vale
NL_CAT_LOCALE usará la
configuración de localización actual para
LC_MESSAGES. En
otro caso usará la variable de entorno
LANG.
La función
catclose() cierra el catálogo de mensajes
identificado por
catalog. Esto invalida cualquier referencia posterior
al catálogo de mensajes definido por
catalog.
The function
catopen() returns a message catalog descriptor of type
nl_catd on success. On failure, it returns
(nl_catd) -1
and sets
errno to indicate the error. The possible error values include
all possible values for the
open(2) call.
La función
catclose() devuelve 0 en caso de éxito, o -1 en
caso de fallo.
- LC_MESSAGES
- Puede ser el origen de la configuración de
localización LC_MESSAGES, y por tanto determina el idioma a
usar si flag vale NL_CAT_LOCALE.
- LANG
- El idioma a utilizar si flag vale 0.
Para obtener una explicación de los términos usados en esta
sección, véase
attributes(7).
| Interfaz |
Atributo |
Valor |
|
catopen() |
Seguridad del hilo |
MT-Safe env |
|
catclose() |
Seguridad del hilo |
Multi-hilo seguro |
POSIX.1-2001, POSIX.1-2008.
Esta es la descripción de POSIX.1. El valor de glibc para
NL_CAT_LOCALE es 1. El camino por defecto varía, pero
normalmente se suele buscar en un número de sitios por debajo de
/usr/share/locale.
catgets(3),
setlocale(3)
La traducción al español de esta página del manual fue
creada por Sebastian Desimone <
[email protected]>, Gerardo Aburruzaga
García <
[email protected]> y Miguel Pérez Ibars
<
[email protected]>
Esta traducción es documentación libre; lea la
GNU
General Public License Version 3 o posterior con respecto a las
condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.
Si encuentra algún error en la traducción de esta página
del manual, envíe un correo electrónico a
[email protected]