Classe messages

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

Typedefs

Funções de membro

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.

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

_Mensagem
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.

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

_Mensagem
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

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