messages-Klasse

Die Klassenvorlage beschreibt ein Objekt, das als Gebietsschema-Facet dienen kann, um lokalisierte Nachrichten aus einem Katalog von internationalisierten Nachrichten für ein bestimmtes Gebietsschema abzurufen.

Während die Nachrichtenklasse implementiert wird, sind derzeit keine Meldungen vorhanden.

Syntax

template <class CharType>
class messages : public messages_base;

Parameter

CharType
Der Typ, der innerhalb eines Programms zum Codieren von Zeichen in einem Gebietsschema verwendet wird.

Hinweise

Wie bei jedem Gebietsschemafacet hat die statische Objekt-ID einen anfänglichen gespeicherten Wert von NULL. Beim ersten Versuch, auf den gespeicherten Wert zuzugreifen, wird in id ein eindeutiger positiver Wert gespeichert.

Dieses Facet öffnet im Grunde einen Katalog von Meldungen, die in der messages_base-Basisklasse definiert sind, ruft die erforderlichen Informationen ab und schließt den Katalog.

Konstruktoren

Konstruktor	Beschreibung
messages	Die Meldungsfacet-Konstruktorfunktion.

TypeDefs

Typname	Beschreibung
char_type	Ein Zeichentyp, mit dem Meldungen angezeigt werden.
string_type	Ein Typ, der eine Zeichenfolge vom Typ basic_string beschreibt, die Zeichen vom Typ CharType enthält.

Memberfunktionen

Memberfunktion	Beschreibung
close	Schließt den Meldungskatalog.
do_close	Eine virtuelle Funktion, die aufgerufen wird, um den Meldungskatalog zu schließen.
do_get	Eine virtuelle Funktion, die aufgerufen wird, um den Meldungskatalog abzurufen.
do_open	Eine virtuelle Funktion, die aufgerufen wird, um den Meldungskatalog zu öffnen.
get	Ruft den Meldungskatalog ab.
open	Öffnet den Meldungskatalog.

Anforderungen

Header:<locale>

Namespace: std

messages::char_type

Ein Zeichentyp, mit dem Meldungen angezeigt werden.

typedef CharType char_type;

Hinweise

Der Typ stellt ein Synonym für den Vorlagenparameter CharType dar.

messages::close

Schließt den Meldungskatalog.

void close(catalog _Catval) const;

Parameter

_Catval
Der zu schließende Katalog.

Hinweise

Die Memberfunktion ruft do_close(_ Catval) auf.

messages::d o_close

Eine virtuelle Funktion, die aufgerufen wird, um den Meldungskatalog zu schließen.

virtual void do_close(catalog _Catval) const;

Parameter

_Catval
Der zu schließende Katalog.

Hinweise

Die geschützte Memberfunktion schließt den Nachrichtenkatalog _Catval, der durch einen früheren Aufruf von do_open geöffnet werden muss.

_Catval muss aus einem vorher geöffneten Katalog abgerufen werden, der nicht geschlossen wurde.

Beispiel

Siehe das Beispiel für close, mit dem do_close aufgerufen wird.

messages::d o_get

Eine virtuelle Funktion, die aufgerufen wird, um den Meldungskatalog abzurufen.

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

Parameter

_Catval
Der Identifikationswert, der den zu suchenden Katalog angibt.

_Garnitur
Der erste identifizierte, der zum Finden einer Meldung in einem Meldungskatalog verwendet wird.

_Nachricht
Der zweite identifizierte, der zum Finden einer Meldung in einem Meldungskatalog verwendet wird.

_Dfault
Die Zeichenfolge, die zurückgegeben werden soll, wenn ein Fehler auftritt.

Rückgabewert

Beim Fehler wird eine Kopie von _Dfault zurückgegeben. Andernfalls gibt er eine Kopie einer angegebenen Meldungssequenz zurück.

Hinweise

Die geschützte Memberfunktion versucht, eine Nachrichtensequenz aus dem Nachrichtenkatalog _Catval abzurufen. Sie kann _Set, _Message und _Dfault dabei nutzen.

Beispiel

Informationen hierzu finden Sie im Beispiel für get, das do_get aufruft.

messages::d o_open

Eine virtuelle Funktion, die aufgerufen wird, um den Meldungskatalog zu öffnen.

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

Parameter

_Catname
Der Name des zu suchenden Katalogs.

_Loc
Das Gebietsschema, nach dem im Katalog gesucht werden soll.

Rückgabewert

Er gibt einen Wert zurück, der bei einem Fehler kleiner als null ist. Andernfalls kann der Rückgabewert als erstes Argument bei einem späteren Aufruf an get verwendet werden.

Hinweise

Die geschützte Memberfunktion versucht, einen Nachrichtenkatalog zu öffnen, dessen Name _Catname ist. Dabei kann das Gebietsschema _Loc verwendet werden.

Der Rückgabewert sollte als Argument für einen späteren Aufruf an close verwendet werden.

Beispiel

Siehe das Beispiel für open, mit dem do_open aufgerufen wird.

messages::get

Ruft den Meldungskatalog ab.

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

Parameter

_Catval
Der Identifikationswert, der den zu suchenden Katalog angibt.

_Garnitur
Der erste identifizierte, der zum Finden einer Meldung in einem Meldungskatalog verwendet wird.

_Nachricht
Der zweite identifizierte, der zum Finden einer Meldung in einem Meldungskatalog verwendet wird.

_Dfault
Die Zeichenfolge, die zurückgegeben werden soll, wenn ein Fehler auftritt.

Rückgabewert

Beim Fehler wird eine Kopie von _Dfault zurückgegeben. Andernfalls gibt er eine Kopie einer angegebenen Meldungssequenz zurück.

Hinweise

Die Memberfunktion gibt do_get(_Catval,_Set_Message,_Dfault) zurück.

messages::messages

Die Meldungsfacet-Konstruktorfunktion.

explicit messages(
    size_t _Refs = 0);

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

Parameter

_Refs
Integerwert, der zum Angeben des Speicherverwaltungstyps für das Objekt verwendet wird.

_Locname
Der Name des Gebietsschemas.

Hinweise

Die möglichen Werte für den _Refs Parameter und deren Bedeutung sind:

• 0: Die Lebensdauer des Objekts wird von den Gebietsschemas verwaltet, in denen es enthalten ist.

• 1: Die Lebensdauer des Objekts muss manuell verwaltet werden.

• > 1: Diese Werte sind nicht definiert.

Direkte Beispiele hierfür sind nicht möglich, da der Destruktor geschützt ist.

Der Konstruktor initialisiert sein Basisobjekt mit locale::facet(_Refs).

messages::open

Öffnet den Meldungskatalog.

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

Parameter

_Catname
Der Name des zu suchenden Katalogs.

_Loc
Das Gebietsschema, nach dem im Katalog gesucht werden soll.

Rückgabewert

Er gibt einen Wert zurück, der bei einem Fehler kleiner als null ist. Andernfalls kann der Rückgabewert als erstes Argument bei einem späteren Aufruf an get verwendet werden.

Hinweise

Die Memberfunktion gibt do_open(_Catname,_Loc) zurück.

messages::string_type

Ein Typ, der eine Zeichenfolge vom Typ basic_string beschreibt, die Zeichen vom Typ CharType enthält.

typedef basic_string<CharType, Traits, Allocator> string_type;

Hinweise

Der Typ beschreibt eine Spezialisierung der Klassenvorlage basic_string , deren Objekte Kopien der Nachrichtensequenzen speichern können.

Siehe auch

<locale>
messages_base-Klasse
Threadsicherheit in der C++-Standardbibliothek