mensagens Classe

O modelo de classe descreve um objeto que pode servir como uma faceta de localidade para recuperar mensagens localizadas de um catálogo de mensagens internacionalizadas para 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 dentro de um programa para codificar caracteres em uma localidade.

Observações

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

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

Construtores

Typedefs (definições de tipos)

Funções de membro

Requerimentos

Cabeçalho:<localidade>

Espaço de nomes: std

mensagens::char_type

Um tipo de caractere que é usado exibe mensagens.

typedef CharType char_type;

Observações

O tipo é um sinônimo para o 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.

Observações

A função de 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.

Observações

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

_Catval devem ser obtidos de um catálogo aberto anteriormente que não esteja fechado.

Exemplo

Veja o exemplo para fechar, 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.

_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 de _Dfault em caso de falha. Caso contrário, ele retorna uma cópia da sequência de mensagens especificada.

Observações

A função de membro protegido tenta obter uma sequência de mensagens do catálogo de mensagens _Catval. Pode fazer uso de _set, _Message e _Dfault ao fazê-lo.

Exemplo

Veja o exemplo para 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 menos de zero em caso de falha. Caso contrário, o valor retornado pode ser usado como o primeiro argumento em uma chamada posterior para obter.

Observações

A função de membro protegido tenta abrir um catálogo de mensagens cujo nome é _Catname. Ele pode fazer uso da localidade _Loc ao fazê-lo

O valor de retorno deve ser usado como argumento em uma chamada posterior para fechar.

Exemplo

Veja o exemplo para abrir, que chama do_open.

mensagens::obter

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.

_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 de _Dfault em caso de falha. Caso contrário, ele retorna uma cópia da sequência de mensagens especificada.

Observações

A função de membro retorna do_get(_Catval, _Set, _Message_Dfault, ).

mensagens::mensagens

A função do construtor da faceta da 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 para o objeto.

_Locname
O nome da localidade.

Observações

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: Estes valores não estão definidos.

Não são possíveis exemplos diretos, porque 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 menos de zero em caso de falha. Caso contrário, o valor retornado pode ser usado como o primeiro argumento em uma chamada posterior para obter.

Observações

A função de 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;

Observações

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

Ver também

<localidade>
messages_base Classe
segurança de threads na biblioteca padrão C++