messages — Klasa

Szablon klasy opisuje obiekt, który może służyć jako aspekt ustawień regionalnych do pobierania zlokalizowanych komunikatów z wykazu międzynarodowych komunikatów dla danego ustawienia regionalnego.

Obecnie gdy klasa komunikatów jest implementowana, nie ma żadnych komunikatów.

Składnia

template <class CharType>
class messages : public messages_base;

Parametry

Typ char
Typ używany w programie do kodowania znaków w ustawieniach regionalnych.

Uwagi

Podobnie jak w przypadku dowolnego zestawu reguł ustawień regionalnych, identyfikator obiektu statycznego ma początkową przechowywaną wartość zero. Pierwsza próba uzyskania dostępu do przechowywanej wartości przechowuje unikatową wartość dodatnią w identyfikatorze.

W zasadzie ten zestaw reguł otwiera katalog komunikatów zdefiniowany w klasie bazowej messages_base, pobiera wymagane informacje i zamyka katalog.

Konstruktory

Definicje typów

Funkcje składowe

Wymagania

Nagłówek:<ustawienia regionalne>

Przestrzeń nazw: std

messages::char_type

Typ znaku, który jest używany do wyświetlania komunikatów.

typedef CharType char_type;

Uwagi

Typ jest synonimem parametru CharType szablonu.

messages::close

Zamyka katalog komunikatów.

void close(catalog _Catval) const;

Parametry

_Catval
Wykaz, który ma zostać zamknięty.

Uwagi

Funkcja składowa wywołuje do_close(_ Catval).

messages::d o_close

Funkcja wirtualna wywoływana, aby zamknąć katalog komunikatów.

virtual void do_close(catalog _Catval) const;

Parametry

_Catval
Wykaz, który ma zostać zamknięty.

Uwagi

Chroniona funkcja składowa zamyka _Catval wykazu komunikatów, który musi zostać otwarty przez wcześniejsze wywołanie do_open.

_Catval należy uzyskać z wcześniej otwartego katalogu, który nie jest zamknięty.

Przykład

Zobacz przykład zamknięcia, który wywołuje metodę do_close.

messages::d o_get

Funkcja wirtualna wywoływana, aby pobrać katalog komunikatów.

virtual string_type do_get(
    catalog _Catval,
    int _Set,
    int _Message,
    const string_type& _Dfault) const;

Parametry

_Catval
Wartość identyfikacji określająca wykaz komunikatów do przeszukania.

_Zbiór
Pierwsza zidentyfikowana użyta do zlokalizowania komunikatu w wykazie komunikatów.

_Komunikat
Druga zidentyfikowana użyta do zlokalizowania komunikatu w wykazie komunikatów.

_Dfault
Ciąg, który ma zostać zwrócony po awarii.

Wartość zwracana

Zwraca kopię _Dfault po awarii. W przeciwnym razie zwraca kopię określonej sekwencji komunikatów.

Uwagi

Chroniona funkcja składowa próbuje uzyskać sekwencję komunikatów z katalogu komunikatów _Catval. Może korzystać z _Set, _Message i _Dfault w ten sposób.

Przykład

Zobacz przykład get, który wywołuje metodę do_get.

messages::d o_open

Funkcja wirtualna wywoływana, aby otworzyć katalog komunikatów.

virtual catalog do_open(
    const string& _Catname,
    const locale& _Loc) const;

Parametry

_Catname
Nazwa wykazu, który ma zostać przeszukany.

_Loc
Ustawienia regionalne wyszukiwane w wykazie.

Wartość zwracana

Zwraca wartość, która porównuje wartość mniejszą niż zero w przypadku awarii. W przeciwnym razie zwrócona wartość może służyć jako pierwszy argument w późniejszym wywołaniu, aby uzyskać.

Uwagi

Chroniona funkcja składowa próbuje otworzyć wykaz komunikatów, którego nazwa jest _Catname. Może on korzystać z ustawień regionalnych _Loc w ten sposób

Wartość zwracana powinna być używana jako argument w późniejszym wywołaniu w celu zamknięcia.

Przykład

Zobacz przykład otwierania, który wywołuje metodę do_open.

messages::get

Pobiera katalog komunikatów.

string_type get(
    catalog _CatVal,
    int _Set,
    int _Message,
    const string_type& _Dfault) const;

Parametry

_Catval
Wartość identyfikacji określająca wykaz komunikatów do przeszukania.

_Zbiór
Pierwsza zidentyfikowana użyta do zlokalizowania komunikatu w wykazie komunikatów.

_Komunikat
Druga zidentyfikowana użyta do zlokalizowania komunikatu w wykazie komunikatów.

_Dfault
Ciąg, który ma zostać zwrócony po awarii.

Wartość zwracana

Zwraca kopię _Dfault po awarii. W przeciwnym razie zwraca kopię określonej sekwencji komunikatów.

Uwagi

Funkcja składowa zwraca do_get(_Catval, _Set, _Message, _Dfault).

messages::messages

Funkcja konstruktora zestawu reguł komunikatów.

explicit messages(
    size_t _Refs = 0);

protected: messages(
    const char* _Locname,
    size_t _Refs = 0);

Parametry

_Bibl.
Wartość całkowita używana do określania typu zarządzania pamięcią dla obiektu.

_Locname
Nazwa ustawień regionalnych.

Uwagi

Możliwe wartości parametru _Refs i ich istotności to:

• 0: Okres istnienia obiektu jest zarządzany przez ustawienia regionalne, które go zawierają.

• 1: Okres istnienia obiektu musi być zarządzany ręcznie.

• > 1: Te wartości nie są zdefiniowane.

Nie są możliwe żadne bezpośrednie przykłady, ponieważ destruktor jest chroniony.

Konstruktor inicjuje obiekt podstawowy za pomocą ustawień regionalnych::facet(_Refs).

messages::open

Otwiera katalog komunikatów.

catalog open(
    const string& _Catname,
    const locale& _Loc) const;

Parametry

_Catname
Nazwa wykazu, który ma zostać przeszukany.

_Loc
Ustawienia regionalne wyszukiwane w wykazie.

Wartość zwracana

Zwraca wartość, która porównuje wartość mniejszą niż zero w przypadku awarii. W przeciwnym razie zwrócona wartość może służyć jako pierwszy argument w późniejszym wywołaniu, aby uzyskać.

Uwagi

Funkcja składowa zwraca wartość do_open(_Catname, _Loc).

messages::string_type

Typ opisujący ciąg typu basic_string zawierający znaki typu CharType.

typedef basic_string<CharType, Traits, Allocator> string_type;

Uwagi

Typ opisuje specjalizację szablonu klasy basic_string , którego obiekty mogą przechowywać kopie sekwencji komunikatów.

Zobacz też

<ustawienia regionalne>
messages_base, klasa
Bezpieczeństwo wątku w standardowej bibliotece C++