Класс messages

Шаблон класса описывает объект, который может служить аспектом языкового стандарта для получения локализованных сообщений из каталога международных сообщений для заданного языкового стандарта.

В настоящее время при использовании данного класса сообщений сообщения не создаются.

Синтаксис

template <class CharType>
class messages : public messages_base;

Параметры

CharType
Тип, используемый внутри программы для кодирования символов в языковом стандарте.

Замечания

Как и в случае любого другого аспекта языкового стандарта, начальное сохраненное значение статического идентификатора объекта равно нулю. Первая попытка получить доступ к сохраненному значению сохранит уникальное положительное значение в id.

По сути, этот аспект открывает каталог сообщений, заданных в базовом классе messages_base, извлекает необходимую информацию и закрывает каталог.

Конструкторы

Конструктор	Description
messages	Функция конструктора аспекта сообщения.

Определения типов

Введите имя	Description
char_type	Тип символа, используемого для отображения сообщений.
string_type	Тип, описывающий строку типа basic_string, содержащую символы типа CharType.

Функции элементов

Функция-член	Description
close	Закрывает каталог сообщений.
do_close	Виртуальная функция, вызываемая для закрытия каталога сообщений.
do_get	Виртуальная функция, вызываемая для извлечения каталога сообщений.
do_open	Виртуальная функция, вызываемая для открытия каталога сообщений.
get	Извлекает каталог сообщений.
open	Открывает каталог сообщений.

Требования

Заголовок:<языковой стандарт>

Пространство имен: std

messages::char_type

Тип символа, используемого для отображения сообщений.

typedef CharType char_type;

Замечания

Тип является синонимом для параметра-шаблона CharType.

messages::close

Закрывает каталог сообщений.

void close(catalog _Catval) const;

Параметры

_Catval
Каталог для закрытия.

Замечания

Функция-член вызывает do_close(_ Catval).

messages::d o_close

Виртуальная функция, вызываемая для закрытия каталога сообщений.

virtual void do_close(catalog _Catval) const;

Параметры

_Catval
Каталог для закрытия.

Замечания

Функция защищенного члена закрывает _Catval каталога сообщений, который должен быть открыт более ранним вызовом do_open.

Значение _Catval должно быть получено из ранее открытого каталога, который не закрыт.

Пример

См. пример для close, в котором вызывается do_close.

messages::d o_get

Виртуальная функция, вызываемая для извлечения каталога сообщений.

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

Параметры

_Catval
Значение идентификации, указывающее каталог сообщений для поиска.

_Набор
Первый идентификатор, использованный для поиска сообщения в каталоге сообщений.

_Сообщение
Второй идентификатор, использованный для поиска сообщения в каталоге сообщений.

_Dfault
Строка, которая будет возвращаться при сбое.

Возвращаемое значение

Он возвращает копию _Dfault при сбое. В противном случае он возвращает копию указанной последовательности сообщений.

Замечания

Защищенная функция-член пытается получить последовательность сообщений из _Catval каталога сообщений. Он может использовать _Set, _Message и _Dfault делать это.

Пример

См. пример для get, который вызывает do_get.

messages::d o_open

Виртуальная функция, вызываемая для открытия каталога сообщений.

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

Параметры

_Catname
Имя каталога для поиска.

_Положение
Языковой стандарт, который ищется в каталоге.

Возвращаемое значение

Он возвращает значение, которое при сбое получает значение меньше нуля. В противном случае возвращаемое значение может использоваться в качестве первого аргумента в последующем вызове get.

Замечания

Функция защищенного члена пытается открыть каталог сообщений, имя которого _Catname. Это может использовать языковой стандарт _Loc при этом

Возвращаемое значение следует использовать как аргумент для последующего вызова close.

Пример

См. пример для open, в котором вызывается do_open.

messages::get

Извлекает каталог сообщений.

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

Параметры

_Catval
Значение идентификации, указывающее каталог сообщений для поиска.

_Набор
Первый идентификатор, использованный для поиска сообщения в каталоге сообщений.

_Сообщение
Второй идентификатор, использованный для поиска сообщения в каталоге сообщений.

_Dfault
Строка, которая будет возвращаться при сбое.

Возвращаемое значение

Он возвращает копию _Dfault при сбое. В противном случае он возвращает копию указанной последовательности сообщений.

Замечания

Функция-член возвращает do_get(_Catval, _Set, _Message, _Dfault).

messages::messages

Функция конструктора аспекта сообщения.

explicit messages(
    size_t _Refs = 0);

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

Параметры

_Refs
Целочисленное значение, используемое для указания типа управления памятью для объекта.

_Locname
Имя языкового стандарта.

Замечания

Возможные значения параметра _Refs и их значение:

• 0: время существования объекта управляется языковыми стандартами, которые его содержат.

• 1: время существования объекта должно управляться вручную.

• > 1. Эти значения не определены.

Прямые примеры привести нельзя, так как деструктор защищен.

Конструктор инициализирует свой базовый объект с locale::facet(_Refs).

messages::open

Открывает каталог сообщений.

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

Параметры

_Catname
Имя каталога для поиска.

_Положение
Языковой стандарт, который ищется в каталоге.

Возвращаемое значение

Он возвращает значение, которое при сбое получает значение меньше нуля. В противном случае возвращаемое значение может использоваться в качестве первого аргумента в последующем вызове get.

Замечания

Функция-член возвращает do_open(_Catname, _Loc).

messages::string_type

Тип, описывающий строку типа basic_string, содержащую символы типа CharType.

typedef basic_string<CharType, Traits, Allocator> string_type;

Замечания

Тип описывает специализацию шаблона класса basic_string объекты которых могут хранить копии последовательностей сообщений.

См. также

<локаль>
Класс messages_base
Потокобезопасность в стандартной библиотеке C++