Namespaces
Variants

std::messages<CharT>:: open, std::messages<CharT>:: do_open

From cppreference.net
C++
Text processing library
Localization library
std::messages
Definiert im Header <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)
1) Öffentliche Memberfunktion, ruft die geschützte virtuelle Memberfunktion do_open der am meisten abgeleiteten Klasse auf.
2) Erhält einen Wert vom Typ catalog (geerbt von std::messages_base ), der an get() übergeben werden kann, um Nachrichten aus dem durch name benannten Nachrichtenkatalog abzurufen. Dieser Wert ist verwendbar, bis er an close() übergeben wird.

Inhaltsverzeichnis

Parameter

name - Name des zu öffnenden Nachrichtenkatalogs
loc - Ein Locale-Objekt, das zusätzliche Facetten bereitstellt, die zum Lesen von Nachrichten aus dem Katalog erforderlich sein können, wie z.B. std::codecvt zur Durchführung von Wide/Multibyte-Konvertierungen

Rückgabewert

Der nicht-negative Wert vom Typ catalog , der mit get() und close() verwendet werden kann. Gibt einen negativen Wert zurück, falls der Katalog nicht geöffnet werden konnte.

Hinweise

Auf POSIX-Systemen übersetzt sich dieser Funktionsaufruf normalerweise in einen Aufruf von catopen() . In GNU libstdc++ ruft es textdomain auf.

Der tatsächliche Katalogort ist implementierungsdefiniert: für den Katalog "sed" (Nachrichtenkataloge, die mit dem Unix-Utility 'sed' installiert wurden) im deutschen Gebietsschema kann die durch diesen Funktionsaufruf geöffnete Datei beispielsweise /usr/lib/nls/msg/de_DE/sed.cat , /usr/lib/locale/de_DE/LC_MESSAGES/sed.cat , oder /usr/share/locale/de/LC_MESSAGES/sed.mo sein.

Beispiel

Das folgende Beispiel demonstriert das Abrufen von Nachrichten: Auf einem typischen GNU/Linux-System liest es aus /usr/share/locale/de/LC_MESSAGES/sed.mo .

Diesen Code ausführen 
#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);
}

Mögliche Ausgabe: 

"No match" in German: Keine Übereinstimmung
"Memory exhausted" in German: Speicher erschöpft

Siehe auch