Scroll to navigation

catopen(3) Library Functions Manual catopen(3)

NOMBRE

catopen, catclose - abre/cierra un catálogo de mensajes

BIBLIOTECA

Biblioteca Estándar C (libc, -lc)

SINOPSIS

#include <nl_types.h>
nl_catd catopen(const char *name, int flag);
int catclose(nl_catd catalog);

DESCRIPCIÓN

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.

VALOR DEVUELTO

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.

ENTORNO

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.
El idioma a utilizar si flag vale 0.

ATRIBUTOS

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

ESTÁNDARES

POSIX.1-2001, POSIX.1-2008.

NOTAS

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.

VÉASE TAMBIÉN

catgets(3), setlocale(3)

TRADUCCIÓN

La traducción al español de esta página del manual fue creada por Sebastian Desimone <chipy@argenet.com.ar>, Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es> y Miguel Pérez Ibars <mpi79470@alu.um.es>

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 debian-l10n-spanish@lists.debian.org.

5 Febrero 2023 Páginas de manual de Linux 6.03