Sdílet prostřednictvím


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++