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

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.

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.