messages – třída
Šablona třídy popisuje objekt, který může sloužit jako omezující vlastnost národního prostředí pro načtení lokalizovaných zpráv z katalogu internationalizovaných zpráv pro dané národní prostředí.
Je-li třída zpráv aktuálně implementována, nejsou k dispozici žádné zprávy.
Syntaxe
template <class CharType>
class messages : public messages_base;
Parametry
CharType
Typ používaný v rámci programu ke kódování znaků v národním prostředí.
Poznámky
Stejně jako u omezující vlastnosti národního prostředí má ID statického objektu počáteční uloženou hodnotu nula. První pokus o přístup k uložené hodnotě ukládá jedinečnou kladnou hodnotu v ID.
Tato omezující vlastnost v podstatě otevře katalog zpráv definovaný v základní třídě messages_base, načte požadované informace a katalog zavře.
Konstruktory
Konstruktor | Popis |
---|---|
zprávy | Funkce konstruktoru omezující vlastnosti zpráv. |
Typedefs
Název typu | Popis |
---|---|
char_type | Typ znaku, který je používán pro zobrazení zpráv. |
string_type | Typ, který popisuje řetězec typu basic_string obsahující znaky typu CharType . |
Členské funkce
Členová funkce | Popis |
---|---|
close | Zavře katalog zpráv. |
do_close | Virtuální funkce volaná k zavření katalogu zpráv. |
do_get | Virtuální funkce volaná k načtení katalogu zpráv. |
do_open | Virtuální funkce volaná k otevření katalogu zpráv. |
get | Načte katalog zpráv. |
open | Otevře katalog zpráv. |
Požadavky
Záhlaví:<národní prostředí>
Namespace: std
messages::char_type
Typ znaku, který je používán pro zobrazení zpráv.
typedef CharType char_type;
Poznámky
Typ je synonymem parametru šablony CharType.
messages::close
Zavře katalog zpráv.
void close(catalog _Catval) const;
Parametry
_Catval
Katalog, který se má zavřít.
Poznámky
Členová funkce volá do_close(_ Catval).
messages::d o_close
Virtuální funkce volaná k zavření katalogu zpráv.
virtual void do_close(catalog _Catval) const;
Parametry
_Catval
Katalog, který se má zavřít.
Poznámky
Chráněná členová funkce zavře _Catval katalogu zpráv, která musí být otevřena dřívějším voláním do_open.
_Catval musí být získán z dříve otevřeného katalogu, který není uzavřen.
Příklad
Podívejte se na příklad uzavření, který volání do_close
.
messages::d o_get
Virtuální funkce volaná k načtení katalogu zpráv.
virtual string_type do_get(
catalog _Catval,
int _Set,
int _Message,
const string_type& _Dfault) const;
Parametry
_Catval
Identifikační hodnota určující katalog zpráv, který se má prohledávat.
_Nastavit
První identifikovaný k vyhledání zprávy v katalogu zpráv.
_Zpráva
Druhá identifikovaná pro vyhledání zprávy v katalogu zpráv.
_Dfault
Řetězec, který se má vrátit při selhání.
Návratová hodnota
Vrátí kopii _Dfault při selhání. V opačném případě vrátí kopii zadané sekvence zpráv.
Poznámky
Chráněná členová funkce se pokusí získat posloupnost zpráv z katalogu zpráv _Catval. Může využívat _Set, _Message a _Dfault .
Příklad
Podívejte se na příklad získání volání do_get
.
messages::d o_open
Virtuální funkce volaná k otevření katalogu zpráv.
virtual catalog do_open(
const string& _Catname,
const locale& _Loc) const;
Parametry
_Catname
Název katalogu, který se má prohledávat.
_Loc
Národní prostředí, které se hledá v katalogu.
Návratová hodnota
Vrátí hodnotu, která porovnává méně než nulu při selhání. V opačném případě lze vrácenou hodnotu použít jako první argument při pozdějším volání získat.
Poznámky
Chráněná členová funkce se pokusí otevřít katalog zpráv, jehož název je _Catname. Může tak využít národní prostředí, _Loc
Návratová hodnota by se měla použít jako argument při pozdějším volání, které se má zavřít.
Příklad
Podívejte se na příklad otevření, který volá do_open
.
messages::get
Načte katalog zpráv.
string_type get(
catalog _CatVal,
int _Set,
int _Message,
const string_type& _Dfault) const;
Parametry
_Catval
Identifikační hodnota určující katalog zpráv, který se má prohledávat.
_Nastavit
První identifikovaný k vyhledání zprávy v katalogu zpráv.
_Zpráva
Druhá identifikovaná pro vyhledání zprávy v katalogu zpráv.
_Dfault
Řetězec, který se má vrátit při selhání.
Návratová hodnota
Vrátí kopii _Dfault při selhání. V opačném případě vrátí kopii zadané sekvence zpráv.
Poznámky
Členová funkce vrátí do_get( _Catval
, _Set
, _Message
, _Dfault
).
messages::messages
Funkce konstruktoru omezující vlastnosti zpráv.
explicit messages(
size_t _Refs = 0);
protected: messages(
const char* _Locname,
size_t _Refs = 0);
Parametry
_Refs
Celočíselná hodnota použitá k určení typu správy paměti pro objekt.
_Locname
Název národního prostředí.
Poznámky
Možné hodnoty pro parametr _Refs a jejich významnost jsou:
0: Životnost objektu je spravována národními prostředími, které ho obsahují.
1: Životnost objektu musí být spravována ručně.
> 1: Tyto hodnoty nejsou definovány.
Nejsou možné žádné přímé příklady, protože destruktor je chráněn.
Konstruktor inicializuje svůj základní objekt s národním prostředím ::facet( _Refs
).
messages::open
Otevře katalog zpráv.
catalog open(
const string& _Catname,
const locale& _Loc) const;
Parametry
_Catname
Název katalogu, který se má prohledávat.
_Loc
Národní prostředí, které se hledá v katalogu.
Návratová hodnota
Vrátí hodnotu, která porovnává méně než nulu při selhání. V opačném případě lze vrácenou hodnotu použít jako první argument při pozdějším volání získat.
Poznámky
Členová funkce vrátí do_open( _Catname
, _Loc
).
messages::string_type
Typ, který popisuje řetězec typu basic_string
obsahující znaky typu CharType
.
typedef basic_string<CharType, Traits, Allocator> string_type;
Poznámky
Typ popisuje specializaci šablony třídy basic_string , jejichž objekty mohou ukládat kopie sekvencí zpráv.
Viz také
<locale>
messages_base – třída
Bezpečný přístup z více vláken ve standardní knihovně C++