Namespaces
Variants

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

From cppreference.net
C++
Text processing library
Localization library
std::messages
Défini dans l'en-tête <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) Fonction membre publique, appelle la fonction membre virtuelle protégée do_open de la classe la plus dérivée.
2) Obtient une valeur de type catalog (héritée de std::messages_base ), qui peut être passée à get() pour récupérer les messages du catalogue de messages nommé par name . Cette valeur est utilisable jusqu'à ce qu'elle soit passée à close() .

Table des matières

Paramètres

name - nom du catalogue de messages à ouvrir
loc - un objet de paramètres régionaux qui fournit des facettes supplémentaires pouvant être nécessaires pour lire les messages du catalogue, telles que std::codecvt pour effectuer des conversions large/multioctet

Valeur de retour

La valeur non négative de type catalog qui peut être utilisée avec get() et close() . Retourne une valeur négative si le catalogue n'a pas pu être ouvert.

Notes

Sur les systèmes POSIX, cet appel de fonction se traduit généralement par un appel à catopen() . Dans GNU libstdc++, il appelle textdomain .

L'emplacement réel du catalogue est défini par l'implémentation : pour le catalogue "sed" (catalogues de messages installés avec l'utilitaire Unix 'sed' ) en locale allemande, par exemple, le fichier ouvert par cet appel de fonction peut être /usr/lib/nls/msg/de_DE/sed.cat , /usr/lib/locale/de_DE/LC_MESSAGES/sed.cat , ou /usr/share/locale/de/LC_MESSAGES/sed.mo .

Exemple

L'exemple suivant démontre la récupération de messages : sur un système GNU/Linux typique, il lit depuis /usr/share/locale/de/LC_MESSAGES/sed.mo .

Exécuter ce code 
#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);
}

Sortie possible : 

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

Voir aussi