berichtenklasse

De klassesjabloon beschrijft een object dat kan fungeren als een facet voor landinstellingen om gelokaliseerde berichten op te halen uit een catalogus met geinternationaliseerde berichten voor een bepaalde landinstelling.

Op dit moment, terwijl de berichtenklasse is geïmplementeerd, zijn er geen berichten.

Syntaxis

template <class CharType>
class messages : public messages_base;

Parameterwaarden

CharType
Het type dat in een programma wordt gebruikt om tekens in een landinstelling te coderen.

Opmerkingen

Net als bij een facet van de landinstelling heeft de statische object-id een initiële opgeslagen waarde van nul. Bij de eerste poging om toegang te krijgen tot de opgeslagen waarde wordt een unieke positieve waarde in id opgeslagen .

Deze facet opent in feite een catalogus met berichten die zijn gedefinieerd in de basisklasse messages_base, haalt de vereiste informatie op en sluit de catalogus.

Constructeurs

Typedefs

Functies voor leden

Behoeften

Rubriek:<oord>

naamruimte: std

berichten::char_type

Een tekentype dat wordt gebruikt, geeft berichten weer.

typedef CharType char_type;

Opmerkingen

Het type is een synoniem voor de sjabloonparameter CharType.

berichten::sluiten

Hiermee sluit u de berichtencatalogus.

void close(catalog _Catval) const;

Parameterwaarden

_Catval
De catalogus die moet worden gesloten.

Opmerkingen

De lidfunctie roept do_close(_ Catval) aan.

messages::d o_close

Een virtuele functie die wordt aangeroepen om de berichtencatalogus te verliezen.

virtual void do_close(catalog _Catval) const;

Parameterwaarden

_Catval
De catalogus die moet worden gesloten.

Opmerkingen

De functie beveiligd lid sluit de berichtencatalogus _Catval, die moet zijn geopend door een eerdere aanroep naar do_open.

_Catval moet worden verkregen uit een eerder geopende catalogus die niet is gesloten.

Voorbeeld

Zie het voorbeeld voor sluiten, welke aanroepen do_close.

messages::d o_get

Een virtuele functie die wordt aangeroepen om de berichtencatalogus op te halen.

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

Parameterwaarden

_Catval
De identificatiewaarde die de berichtencatalogus aangeeft die moet worden doorzocht.

_Set
De eerste geïdentificeerd om een bericht in een berichtencatalogus te zoeken.

_Bericht
De tweede geïdentificeerd die wordt gebruikt om een bericht in een berichtencatalogus te vinden.

_Dfault
De tekenreeks die moet worden geretourneerd bij een fout.

Retourwaarde

Er wordt een kopie van _Dfault geretourneerd bij een fout. Anders wordt een kopie van de opgegeven berichtenreeks geretourneerd.

Opmerkingen

De functie beveiligd lid probeert een berichtenreeks te verkrijgen uit de berichtencatalogus _Catval. Hierbij kan gebruik wordengemaakt van _Set, _Message en _Dfault .

Voorbeeld

Zie het voorbeeld voor get, welke aanroepen do_get.

messages::d o_open

Een virtuele functie die wordt aangeroepen om de berichtencatalogus te openen.

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

Parameterwaarden

_Catname
De naam van de catalogus die moet worden doorzocht.

_LOC
De landinstelling die wordt gezocht in de catalogus.

Retourwaarde

Deze retourneert een waarde die kleiner is dan nul bij fouten. Anders kan de geretourneerde waarde worden gebruikt als het eerste argument in een latere aanroep om te verkrijgen.

Opmerkingen

De functie beveiligd lid probeert een berichtencatalogus te openen waarvan de naam is _Catname. Hierbij kan gebruik wordengemaakt van de landinstelling _Loc

De retourwaarde moet worden gebruikt als het argument in een latere aanroep om te sluiten.

Voorbeeld

Zie het voorbeeld voor openen, welke aanroepen do_open.

berichten::get

Haalt de berichtencatalogus op.

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

Parameterwaarden

_Catval
De identificatiewaarde die de berichtencatalogus aangeeft die moet worden doorzocht.

_Set
De eerste geïdentificeerd om een bericht in een berichtencatalogus te zoeken.

_Bericht
De tweede geïdentificeerd die wordt gebruikt om een bericht in een berichtencatalogus te vinden.

_Dfault
De tekenreeks die moet worden geretourneerd bij een fout.

Retourwaarde

Er wordt een kopie van _Dfault geretourneerd bij een fout. Anders wordt een kopie van de opgegeven berichtenreeks geretourneerd.

Opmerkingen

De lidfunctie retourneert do_get(_Catval, _Set, _Message, ). _Dfault

berichten::berichten

De facetconstructorfunctie van het bericht.

explicit messages(
    size_t _Refs = 0);

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

Parameterwaarden

_Refs
Een geheel getal dat wordt gebruikt om het type geheugenbeheer voor het object op te geven.

_Locname
De naam van de landinstelling.

Opmerkingen

De mogelijke waarden voor de parameter _Refs en hun significantie zijn:

• 0: De levensduur van het object wordt beheerd door de landinstellingen die het object bevatten.

• 1: De levensduur van het object moet handmatig worden beheerd.

• > 1: Deze waarden zijn niet gedefinieerd.

Er zijn geen directe voorbeelden mogelijk, omdat de destructor is beveiligd.

De constructor initialiseert het basisobject met landinstelling::facet(_Refs).

berichten::openen

Hiermee opent u de berichtencatalogus.

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

Parameterwaarden

_Catname
De naam van de catalogus die moet worden doorzocht.

_LOC
De landinstelling die wordt gezocht in de catalogus.

Retourwaarde

Deze retourneert een waarde die kleiner is dan nul bij fouten. Anders kan de geretourneerde waarde worden gebruikt als het eerste argument in een latere aanroep om te verkrijgen.

Opmerkingen

De lidfunctie retourneert do_open(_Catname, _Loc).

berichten::string_type

Een type dat een tekenreeks basic_string beschrijft die tekens van het type bevat CharType.

typedef basic_string<CharType, Traits, Allocator> string_type;

Opmerkingen

Het type beschrijft een specialisatie van klassesjabloon basic_string waarvan objecten kopieën van de berichtreeksen kunnen opslaan.

Zie ook

<oord>
messages_base-klasse
Thread Safety in de standaardbibliotheek van C++