std::use_facet

 

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

 

Definiert in Header <locale>
template< class Facet > const Facet& use_facet( const std::locale& loc );

Ruft eine Referenz auf ein von loc implementiertes Facet ab.

Das Programm ist schlecht geformt, wenn Facet kein Facet ist, dessen Definition das öffentliche statische Mitglied id enthält, oder wenn es sich um ein volatil qualifiziertes Facet handelt.

Parameter

loc

-

das abzufragende Locale-Objekt

Rückgabewert

Gibt eine Referenz auf das Facet zurück. Die von dieser Funktion zurückgegebene Referenz ist gültig, solange irgendein std::locale-Objekt auf dieses Facet verweist.

Ausnahmen

std::bad_cast wenn std::has_facet<Facet>(loc) == false.

Hinweise

Ein std::locale-Objekt sollte kein temporäres Objekt sein, wenn eine Referenz auf das von use_facet erhaltene Facet-Objekt nach dem Ende der Anweisung verwendet wird.

// BAD:
auto& f = std::use_facet<std::moneypunct<char, true>>(std::locale{"no_NO.UTF-8"});
foo(f.curr_symbol()); // Error: f internally uses a dangling reference
                      // to a std::locale object that no longer exists.
// GOOD:
auto loc = std::locale{"is_IS.UTF-8"}; // OK: a non-temporary object
auto& f = std::use_facet<std::moneypunct<char, true>>(loc);
foo(f.curr_symbol()); // OK: f internally uses a reference to existing locale object.

Beispiel

Zeigt den 3-Buchstaben-Währungsnamen an, der vom bevorzugten Locale des Benutzers verwendet wird.

Führen Sie diesen Code aus

#include <iostream>
#include <locale>
 
int main()
{
    for (const char* name: {"en_US.UTF-8", "de_DE.UTF-8", "en_GB.UTF-8"})
        std::cout << "Your currency string is "
                  << std::use_facet<std::moneypunct<char, true>>(std::locale{name}).
                     curr_symbol() << '\n';
}

Ausgabe

Your currency string is USD
Your currency string is EUR
Your currency string is GBP

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 31	C++98	die zurückgegebene Referenz blieb nutzbar solange der Locale-Wert selbst existierte	die zurückgegebene Referenz bleibt nutzbar, solange irgendein Locale-Objekt auf dieses Facet verweist
LWG 38	C++98	Facet musste kein direktes Member id haben	Gefordert
LWG 436	C++98	Es war unklar, ob Facet cv-qualifiziert sein kann	Es kann const-qualifiziert sein, aber nicht volatile-qualifiziert

Siehe auch

locale	Satz von polymorphen Facetten, die kulturelle Unterschiede kapseln (Klasse)
has_facet	prüft, ob eine Locale eine bestimmte Facette implementiert (Funktionstemplate)