Partilhar via

Classe messages

  • Artigo

O modelo de classe descreve um objeto que pode servir como uma faceta de localidade para recuperar mensagens localizadas em um catálogo de mensagens internacionalizadas de uma determinada localidade.

Atualmente, enquanto a classe de mensagens é implementada, não há mensagens.

Sintaxe

template <class CharType>
class messages : public messages_base;

Parâmetros

CharType
O tipo usado em um programa para codificar caracteres em uma localidade.

Comentários

Como qualquer faceta de localidade, a ID de objeto estático tem um valor armazenado inicial de zero. A primeira tentativa de acessar seu valor armazenado armazena um valor positivo exclusivo na id.

Essa faceta, basicamente, abre um catálogo de mensagens definido na classe base messages_base, recupera as informações necessárias e fecha o catálogo.

Construtores

Construtor Descrição
messages A função de construtor de faceta de mensagem.

Typedefs

Nome do tipo Descrição
char_type Um tipo de caractere usado para exibir mensagens.
string_type Um tipo que descreve uma cadeia de caracteres do tipo basic_string que contém caracteres do tipo CharType.

Funções de membro

Função de membro Descrição
close Fecha o catálogo de mensagens.
do_close Uma função virtual chamada para perder o catálogo de mensagens.
do_get Uma função virtual chamada para recuperar o catálogo de mensagens.
do_open Uma função virtual chamada para abrir o catálogo de mensagens.
get Recupera o catálogo de mensagens.
abrir Abre o catálogo de mensagens.

Requisitos

Cabeçalho:<locale>

Namespace: std

mensagens::char_type

Um tipo de caractere usado para exibir mensagens.

typedef CharType char_type;

Comentários

O tipo é um sinônimo do parâmetro de modelo CharType.

mensagens::fechar

Fecha o catálogo de mensagens.

void close(catalog _Catval) const;

Parâmetros

_Catval
O catálogo a ser fechado.

Comentários

A função membro chama do_close(_ Catval).

mensagens::d o_close

Uma função virtual chamada para perder o catálogo de mensagens.

virtual void do_close(catalog _Catval) const;

Parâmetros

_Catval
O catálogo a ser fechado.

Comentários

A função membro protegido fecha o catálogo de mensagens _Catval, que deve ter sido aberto por uma chamada anterior para do_open.

_Catval deve ser obtido de um catálogo aberto anteriormente que não está fechado.

Exemplo

Consulte o exemplo de close, que chama do_close.

mensagens::d o_get

Uma função virtual chamada para recuperar o catálogo de mensagens.

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

Parâmetros

_Catval
O valor de identificação que especifica o catálogo de mensagens a ser pesquisado.

_Set
O primeiro identificado usado para localizar uma mensagem em um catálogo de mensagens.

_Message
O segundo identificado usado para localizar uma mensagem em um catálogo de mensagens.

_Dfault
A cadeia de caracteres a ser retornada em caso de falha.

Valor de retorno

Ele retorna uma cópia do _Dfault em caso de falha. Caso contrário, ela retorna uma cópia da sequência de mensagem especificada.

Comentários

A função membro protegida tenta obter uma sequência de mensagens do catálogo de mensagens _Catval. Com isso, poderá usar _Set, _Message e _Dfault.

Exemplo

Consulte o exemplo de get, que chama do_get.

mensagens::d o_open

Uma função virtual chamada para abrir o catálogo de mensagens.

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

Parâmetros

_Catname
O nome do catálogo a ser pesquisado.

_Loc
A localidade que está sendo pesquisada no catálogo.

Valor de retorno

Ele retorna um valor que compara menor que zero na falha. Caso contrário, o valor retornado pode ser usado como o primeiro argumento em uma chamada posterior para get.

Comentários

A função membro protegida tenta abrir um catálogo de mensagens cujo nome é _Catname. Dessa forma, ela pode fazer uso da localidade _Loc

O valor retornado deve ser usado como o argumento em uma chamada posterior para close.

Exemplo

Consulte o exemplo de open, que chama do_open.

mensagens::get

Recupera o catálogo de mensagens.

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

Parâmetros

_Catval
O valor de identificação que especifica o catálogo de mensagens a ser pesquisado.

_Set
O primeiro identificado usado para localizar uma mensagem em um catálogo de mensagens.

_Message
O segundo identificado usado para localizar uma mensagem em um catálogo de mensagens.

_Dfault
A cadeia de caracteres a ser retornada em caso de falha.

Valor de retorno

Ele retorna uma cópia do _Dfault em caso de falha. Caso contrário, ela retorna uma cópia da sequência de mensagem especificada.

Comentários

A função membro retorna do_get( _Catval, _Set, _Message, _Dfault).

mensagens::mensagens

A função de construtor de faceta de mensagem.

explicit messages(
    size_t _Refs = 0);

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

Parâmetros

_Refs
Valor inteiro usado para especificar o tipo de gerenciamento de memória do objeto.

_Locname
O nome da localidade.

Comentários

Os valores possíveis para o parâmetro _Refs e sua significância são:

  • 0: o tempo de vida do objeto é gerenciado pelas localidades que o contêm.

  • 1: o tempo de vida do objeto deve ser gerenciado manualmente.

  • > 1: esses valores não estão definidos.

Nenhum exemplo direto é possível, pois o destruidor está protegido.

O construtor inicializa seu objeto base com locale::facet( _Refs).

mensagens::abrir

Abre o catálogo de mensagens.

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

Parâmetros

_Catname
O nome do catálogo a ser pesquisado.

_Loc
A localidade que está sendo pesquisada no catálogo.

Valor de retorno

Ele retorna um valor que compara menor que zero na falha. Caso contrário, o valor retornado pode ser usado como o primeiro argumento em uma chamada posterior para get.

Comentários

A função membro retorna do_open( _Catname, _Loc).

mensagens::string_type

Um tipo que descreve uma cadeia de caracteres do tipo basic_string que contém caracteres do tipo CharType.

typedef basic_string<CharType, Traits, Allocator> string_type;

Comentários

O tipo descreve uma especialização do modelo de classe basic_string cujos objetos podem armazenar cópias das sequências de mensagens.

Confira também

<locale>
Classe messages_base
Acesso Thread-Safe na Biblioteca Padrão C++