View source for cpp/locale/messages byname

{{cpp/title|messages_byname}}
{{cpp/locale/navbar}}
{{dcl begin}}
{{dcl header|locale}}
{{dcl|1=
template< class CharT >
class messages_byname : public std::messages<CharT>;
}}
{{dcl end}}

{{tt|std::messages_byname}} is a {{lc|std::messages}} facet which encapsulates retrieval of strings from message catalogs of the locale specified at its construction.

===Specializations===
The standard library is guaranteed to provide the following specializations:
{{dsc begin}}
{{dsc header | locale }}
{{dsc | {{c/core|std::messages_byname<char>}} | narrow/multibyte message catalog access }}
{{dsc | {{c/core|std::messages_byname<wchar_t>}} | wide string message catalog access }}
{{dsc end}}

===Member types===
{{dsc begin}}
{{dsc hitem | Member type | Definition}}
{{dsc | {{tt|catalog}} | {{c/core|std::messages_base<CharT>::catalog}}}}
{{dsc | {{tt|string_type}} | {{c/core|std::basic_string<CharT>}}}}
{{dsc end}}

===Member functions===
{{dsc begin}}
{{dsc inc | cpp/locale/byname/dsc constructor | messages_byname}}
{{dsc inc | cpp/locale/byname/dsc destructor | messages_byname}}
{{dsc end}}

{{include | cpp/locale/byname/constructor | messages_byname}}
{{include | cpp/locale/byname/destructor | messages_byname}}

{{cpp/locale/messages/inherit}}

===Example===
{{example
| 
|code=
#include <iostream>
#include <locale>
 
void try_with(const std::locale& loc)
{
    const std::messages<char>& facet = std::use_facet<std::messages<char>>(loc);
    
    std::messages<char>::catalog cat = facet.open("sed", std::cout.getloc());
    if (cat < 0)
        std::cout << "Could not open \"sed\" message catalog\n";
    else
        std::cout << "\"No match\" "
                  << facet.get(cat, 0, 0, "No match") << '\n'
                  << "\"Memory exhausted\" " 
                  << facet.get(cat, 0, 0, "Memory exhausted") << '\n';
    
    facet.close(cat);
}

int main()
{
    std::locale loc("en_US.utf8");
    std::cout.imbue(loc);
    
    try_with(std::locale(loc, new std::messages_byname<char>("de_DE.utf8")));
    try_with(std::locale(loc, new std::messages_byname<char>("fr_FR.utf8")));
    try_with(std::locale(loc, new std::messages_byname<char>("ja_JP.utf8")));
}
|p=true
|output=
"No match" Keine Übereinstimmung
"Memory exhausted" Speicher erschöpft
"No match" Pas de concordance
"Memory exhausted" Mémoire épuisée
"No match" 照合しません
"Memory exhausted" メモリーが足りません
}}

===See also===
{{dsc begin}}
{{dsc inc|cpp/locale/dsc messages}}
{{dsc end}}

{{langlinks|de|es|fr|it|ja|pt|ru|zh}}