Classe messages

Il modello di classe descrive un oggetto che può fungere da facet delle impostazioni locali per recuperare i messaggi localizzati da un catalogo di messaggi internazionalizzati per una determinata impostazione locale.

Attualmente, mentre viene implementata la classe dei messaggi, non esiste alcun messaggio.

Sintassi

template <class CharType>
class messages : public messages_base;

Parametri

CharType
Tipo utilizzato all'interno di un programma per codificare i caratteri delle impostazioni locali.

Osservazioni:

Come in qualsiasi facet delle impostazioni locali, l'ID dell'oggetto statico ha un valore archiviato iniziale uguale a zero. Il primo tentativo di accedere a tale valore archiviato consente di archiviare un valore positivo univoco in id.

Questo facet apre fondamentalmente un catalogo di messaggi definiti in messages_base della classe base, recupera le informazioni richieste e chiude il catalogo.

Costruttori

Costruttore	Descrizione
messages	Funzione del costruttore del facet dei messaggi.

Typedef

Nome tipo	Descrizione
char_type	Tipo di carattere utilizzato per visualizzare i messaggi.
string_type	Tipo che descrive una stringa di tipo basic_string contenente caratteri di tipo CharType.

Funzioni membro

Funzione membro	Descrizione
close	Chiude il catalogo dei messaggi.
do_close	Funzione virtuale chiamata perché avvenga la perdita del catalogo dei messaggi.
do_get	Funzione virtuale chiamata per recuperare il catalogo dei messaggi.
do_open	Funzione virtuale chiamata per aprire il catalogo dei messaggi.
get	Recupera il catalogo dei messaggi.
open	Apre il catalogo dei messaggi.

Requisiti

Intestazione:<impostazioni locali>

Spazio dei nomi: std

messages::char_type

Tipo di carattere utilizzato per visualizzare i messaggi.

typedef CharType char_type;

Osservazioni:

Il tipo è un sinonimo del parametro di modello CharType.

messages::close

Chiude il catalogo dei messaggi.

void close(catalog _Catval) const;

Parametri

_Catval
Catalogo da chiudere.

Osservazioni:

La funzione membro chiama do_close(_ Catval).

messages::d o_close

Funzione virtuale chiamata perché avvenga la perdita del catalogo dei messaggi.

virtual void do_close(catalog _Catval) const;

Parametri

_Catval
Catalogo da chiudere.

Osservazioni:

La funzione membro protetta chiude il catalogo dei messaggi _Catval, che deve essere stato aperto da una chiamata precedente a do_open.

È necessario ottenere _Catval da un catalogo aperto in precedenza e non chiuso.

Esempio

Vedere l'esempio relativo a close, che chiama do_close.

messages::d o_get

Funzione virtuale chiamata per recuperare il catalogo dei messaggi.

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

Parametri

_Catval
Valore di identificazione che specifica il catalogo dei messaggi in cui eseguire ricerche.

_Mettere
Primo valore identificato usato per individuare un messaggio in un catalogo dei messaggi.

_Messaggio
Secondo valore identificato usato per individuare un messaggio in un catalogo dei messaggi.

_Dfault
Stringa da restituire in caso di esito negativo.

Valore restituito

Restituisce una copia di _Dfault in caso di errore. In caso contrario, viene restituita una copia della sequenza di messaggi specificata.

Osservazioni:

La funzione membro protetta tenta di ottenere una sequenza di messaggi dal catalogo messaggi _Catval. Può usare _Set, _Message e _Dfault in questo modo.

Esempio

Vedere l'esempio relativo a get, che chiama do_get.

messages::d o_open

Funzione virtuale chiamata per aprire il catalogo dei messaggi.

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

Parametri

_Catname
Nome del catalogo in cui eseguire ricerche.

_Loc
Impostazioni locali da ricercare nel catalogo.

Valore restituito

In caso di esito negativo, viene restituito un valore minore di zero. In caso contrario, il valore restituito può essere usato come primo argomento in una successiva chiamata a get.

Osservazioni:

La funzione membro protetta tenta di aprire un catalogo messaggi il cui nome è _Catname. Può usare le impostazioni locali _Loc in questo modo

Il valore restituito deve essere usato come argomento in una successiva chiamata a close.

Esempio

Vedere l'esempio relativo a open, che chiama do_open.

messages::get

Recupera il catalogo dei messaggi.

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

Parametri

_Catval
Valore di identificazione che specifica il catalogo dei messaggi in cui eseguire ricerche.

_Mettere
Primo valore identificato usato per individuare un messaggio in un catalogo dei messaggi.

_Messaggio
Secondo valore identificato usato per individuare un messaggio in un catalogo dei messaggi.

_Dfault
Stringa da restituire in caso di esito negativo.

Valore restituito

Restituisce una copia di _Dfault in caso di errore. In caso contrario, viene restituita una copia della sequenza di messaggi specificata.

Osservazioni:

La funzione membro restituisce do_get( _Catval, _Set, _Message, _Dfault).

messages::messages

Funzione del costruttore del facet dei messaggi.

explicit messages(
    size_t _Refs = 0);

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

Parametri

_Refs
Valore Integer che consente di specificare il tipo di gestione della memoria per l'oggetto.

_Locname
Nome delle impostazioni locali.

Osservazioni:

I valori possibili per il parametro _Refs e il loro significato sono:

• 0: la durata dell'oggetto è gestita dalle impostazioni locali che lo contengono.

• 1: la durata dell'oggetto deve essere gestita manualmente.

• > 1: questi valori non sono definiti.

Non è possibile fornire esempi diretti, poiché il distruttore è protetto.

Il costruttore inizializza l'oggetto di base con locale::facet( _Refs).

messages::open

Apre il catalogo dei messaggi.

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

Parametri

_Catname
Nome del catalogo in cui eseguire ricerche.

_Loc
Impostazioni locali da ricercare nel catalogo.

Valore restituito

In caso di esito negativo, viene restituito un valore minore di zero. In caso contrario, il valore restituito può essere usato come primo argomento in una successiva chiamata a get.

Osservazioni:

La funzione membro restituisce do_open( _Catname, _Loc).

messages::string_type

Tipo che descrive una stringa di tipo basic_string contenente caratteri di tipo CharType.

typedef basic_string<CharType, Traits, Allocator> string_type;

Osservazioni:

Il tipo descrive una specializzazione del modello di classe basic_string i cui oggetti possono archiviare copie delle sequenze di messaggi.

Vedi anche

<impostazioni locali>
Classe messages_base
Thread Safety in the C++ Standard Library (Sicurezza dei thread nella libreria standard C++)