std::messages<CharT>:: open, std::messages<CharT>:: do_open
|
Definido en el encabezado
<locale>
|
||
|
public
:
catalog open ( const std:: string & name, const std:: locale & loc ) const ; |
(1) | |
|
protected
:
virtual catalog do_open ( const std:: string & name, const std:: locale & loc ) const ; |
(2) | |
do_open
de la clase más derivada.
catalog
(heredado de
std::messages_base
), que puede pasarse a
get()
para recuperar mensajes del catálogo de mensajes nombrado por
name
. Este valor es utilizable hasta que se pasa a
close()
.
Contenidos |
Parámetros
| name | - | nombre del catálogo de mensajes a abrir |
| loc | - | un objeto de configuración regional que proporciona facetas adicionales que pueden requerirse para leer mensajes del catálogo, como std::codecvt para realizar conversiones ancho/multibyte |
Valor de retorno
El valor no negativo de tipo
catalog
que puede ser utilizado con
get()
y
close()
. Retorna un valor negativo si el catálogo no pudo ser abierto.
Notas
En sistemas POSIX, esta llamada de función normalmente se traduce a una llamada a
catopen()
. En GNU libstdc++, llama a
textdomain
.
La ubicación real del catálogo está definida por la implementación: para el catálogo
"sed"
(catálogos de mensajes instalados con la utilidad Unix
'sed'
) en la configuración regional alemana, por ejemplo, el archivo abierto por esta llamada de función puede ser
/usr/lib/nls/msg/de_DE/sed.cat
,
/usr/lib/locale/de_DE/LC_MESSAGES/sed.cat
, o
/usr/share/locale/de/LC_MESSAGES/sed.mo
.
Ejemplo
El siguiente ejemplo demuestra la recuperación de mensajes: en un sistema GNU/Linux típico lee desde
/usr/share/locale/de/LC_MESSAGES/sed.mo
.
#include <iostream> #include <locale> int main() { std::locale loc("de_DE.utf8"); std::cout.imbue(loc); auto& facet = std::use_facet<std::messages<char>>(loc); auto cat = facet.open("sed", loc); if (cat < 0) std::cout << "Could not open german \"sed\" message catalog\n"; else std::cout << "\"No match\" in German: " << facet.get(cat, 0, 0, "No match") << '\n' << "\"Memory exhausted\" in German: " << facet.get(cat, 0, 0, "Memory exhausted") << '\n'; facet.close(cat); }
Salida posible:
"No match" in German: Keine Übereinstimmung "Memory exhausted" in German: Speicher erschöpft