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⟩.