std:: locale

Un objet de la classe std::locale est un ensemble indexé immuable de facettes immuables. Chaque objet de flux de la bibliothèque d'entrée/sortie de C++ est associé à un std::locale et utilise ses facettes pour l'analyse et le formatage de toutes les données. De plus, un objet locale est associé à chaque std::basic_regex . (depuis C++11) Les objets locale peuvent également être utilisés comme prédicats effectuant la collation de chaînes avec les conteneurs et algorithmes standards, et peuvent être accédés directement pour obtenir ou modifier les facettes qu'ils contiennent.

Chaque paramètre régional construit dans un programme C++ contient au moins les facettes standard suivantes (c'est-à-dire que std::has_facet renvoie true pour tous ces types de facettes), mais un programme peut définir des spécialisations supplémentaires ou des facettes entièrement nouvelles et les ajouter à tout objet de paramètre régional existant.

En interne, un objet locale est implémenté comme s'il s'agissait d'un pointeur à comptage de références vers un tableau (indexé par std::locale::id ) de pointeurs à comptage de références vers des facets : copier un locale ne copie qu'un seul pointeur et incrémente plusieurs compteurs de références. Pour maintenir les garanties de sécurité des threads de la bibliothèque standard C++ (les opérations sur différents objets sont toujours thread-safe), le compteur de références du locale et chaque compteur de références de facet sont mis à jour de manière thread-safe, similairement à std::shared_ptr .

Types membres

Constantes membres

std::locale les fonctions membres attendant un argument category nécessitent l'une des valeurs de catégorie définies ci-dessus, ou l'union de deux ou plusieurs de ces valeurs. Les LC constantes ne sont pas acceptées.

Fonctions membres

Exemple

#include <iostream>
#include <locale>
int main()
{
    std::wcout << L"User-preferred locale setting is "
               << std::locale("").name().c_str() << L'\n';
    // on startup, the global locale is the "C" locale
    std::wcout << 1000.01 << L'\n';
    // replace the C++ global locale and the "C" locale with the user-preferred locale
    std::locale::global(std::locale(""));
    // use the new global locale for future wide character output
    std::wcout.imbue(std::locale());
    // output the same number again
    std::wcout << 1000.01 << L'\n';
}

User-preferred locale setting is en_US.UTF8
1000.01
1,000.01

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi