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

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Lokalisierungsbibliothek

Lokale und Facetten   Lokale has_facet use_facet locale Facet-Kategorie Basisklassen ctype_base codecvt_base messages_base time_base money_base ctype-Facetten ctype ctype<char> ctype_byname codecvt codecvt_byname numerische Facetten num_get num_put numpunct numpunct_byname Kollationsfacetten collate collate_byname Zeitfacetten time_get time_put time_get_byname time_put_byname

Geldfacetten money_get money_put moneypunct moneypunct_byname Nachrichtenfacetten messages messages_byname Zeichenklassifizierung und -konvertierung Zeichenklassifizierung isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph Zeichenkonvertierungen toupper    tolower String- und Streamkonvertierungen wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode-Konvertierungsfacets codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) C-Bibliotheks-Lokalisierungen LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

std::nachrichten

Memberfunktionen

nachrichten::nachrichten

nachrichten::~nachrichten

nachrichten::opennachrichten::do_open

nachrichten::getnachrichten::do_get

nachrichten::closenachrichten::do_close

 

Definiert in 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 Member-Funktion, ruft die geschützte virtuelle Member-Funktion do_open der am stärksten abgeleiteten Klasse auf.

2) Holt einen Wert vom Typ catalog (geerbt von std::messages_base), der an get() übergeben werden kann, um Nachrichten aus dem Nachrichten-Catalog mit dem Namen von name abzurufen. Dieser Wert ist verwendbar, bis er an close() übergeben wird.

Parameter

name	-	Name des zu öffnenden Nachrichten-Catalogs
loc	-	Ein Locale-Objekt, das zusätzliche Facetten bereitstellt, die zum Lesen von Nachrichten aus dem Catalog benötigt werden könnten, wie z. B. std::codecvt zur Durchführung von Weit-/Mehrbyte-Konvertierungen.

Rückgabewert

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

Hinweise

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

Der tatsächliche Speicherort des Catalogs ist implementierungsabhängig: für den Catalog "sed" (Nachrichten-Catalogs, die mit dem Unix-Dienstprogramm 'sed' installiert wurden) in der deutschen Locale könnte die von diesem 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 den Abruf von Nachrichten: auf einem typischen GNU/Linux-System liest es aus /usr/share/locale/de/LC_MESSAGES/sed.mo.

Führen Sie diesen Code aus

#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