wstring_convert-klasse

De klassesjabloon wstring_convert voert conversies uit tussen een brede tekenreeks en een bytetekenreeks.

Syntaxis

template <class Codecvt, class Elem = wchar_t>
class wstring_convert

Parameterwaarden

Codecvt
Het facet van de landinstelling dat het conversieobject vertegenwoordigt.

Elem
Het elementtype breedteken.

Opmerkingen

In de klassesjabloon wordt een object beschreven waarmee conversies worden beheerd tussen brede tekenreeksobjecten van klasse std::basic_string<Elem> en bytetekenreeksobjecten van klasse std::basic_string<char> (ook wel bekend als std::string). De klassesjabloon definieert de typen wide_string en byte_string als synoniemen voor deze twee typen. Conversie tussen een reeks Elem waarden (opgeslagen in een wide_string object) en multibytereeksen (opgeslagen in een byte_string object) wordt uitgevoerd door een object van klasse Codecvt<Elem, char, std::mbstate_t>, dat voldoet aan de vereisten van het standaard facet std::codecvt<Elem, char, std::mbstate_t>voor codeconversie.

In een object van deze klassesjabloon wordt het volgende opgeslagen:

• Een bytetekenreeks die moet worden weergegeven bij fouten

• Een brede tekenreeks die moet worden weergegeven bij fouten

• Een aanwijzer naar het toegewezen conversieobject (dat wordt vrijgemaakt wanneer het wbuffer_convert object wordt vernietigd)

• Een conversiestatusobject van het type state_type

• Een conversieaantal

Constructeurs

Typedefs

Functies voor leden

Behoeften

Rubriek:<oord>

naamruimte: std

wstring_convert::byte_string

Een type dat een bytetekenreeks vertegenwoordigt.

typedef std::basic_string<char> byte_string;

Opmerkingen

Het type is een synoniem voor std::basic_string<char>.

wstring_convert::geconverteerd

Retourneert het aantal geslaagde conversies.

size_t converted() const;

Retourwaarde

Het aantal geslaagde conversies.

Opmerkingen

Het aantal geslaagde conversies wordt opgeslagen in het conversieaantalobject.

wstring_convert::from_bytes

Converteert een bytetekenreeks naar een brede tekenreeks.

wide_string from_bytes(char Byte);
wide_string from_bytes(const char* ptr);
wide_string from_bytes(const byte_string& Bstr);
wide_string from_bytes(const char* first, const char* last);

Parameterwaarden

Byte
De bytereeks met één element die moet worden geconverteerd.

ptr
De C-stijl, null-beëindigde reeks tekens die moeten worden geconverteerd.

Bstr
De byte_string die moeten worden geconverteerd.

eerste
Het eerste teken in een reeks tekens die moeten worden geconverteerd.

laatste
Het laatste teken in een reeks tekens die moeten worden geconverteerd.

Retourwaarde

Een breed tekenreeksobject dat het resultaat is van de conversie.

Opmerkingen

Als het conversiestatusobjectniet is samengesteld met een expliciete waarde, wordt het ingesteld op de standaardwaarde (de initiële conversiestatus) voordat de conversie begint. Anders blijft het ongewijzigd.

Het aantal invoerelementen dat is geconverteerd, wordt opgeslagen in het conversieaantalobject. Als er geen conversiefout optreedt, retourneert de lidfunctie de geconverteerde brede tekenreeks. Als het object anders is samengesteld met een initialisatiefunctie voor het foutbericht wide-string, retourneert de lidfunctie het object wide-string error message. Anders genereert de lidfunctie een object van klasse range_error.

wstring_convert::int_type

Een type dat een geheel getal vertegenwoordigt.

typedef typename wide_string::traits_type::int_type int_type;

Opmerkingen

Het type is een synoniem voor wide_string::traits_type::int_type.

wstring_convert::state

Retourneert een object dat de status van de conversie vertegenwoordigt.

state_type state() const;

Retourwaarde

Het conversiestatusobject dat de status van de conversie vertegenwoordigt.

wstring_convert::state_type

Een type dat de conversiestatus vertegenwoordigt.

typedef typename Codecvt::state_type state_type;

Opmerkingen

Het type beschrijft een object dat een conversiestatus kan vertegenwoordigen. Het type is een synoniem voor Codecvt::state_type.

wstring_convert::to_bytes

Converteert een brede tekenreeks naar een bytetekenreeks.

byte_string to_bytes(Elem Char);
byte_string to_bytes(const Elem* Wptr);
byte_string to_bytes(const wide_string& Wstr);
byte_string to_bytes(const Elem* first, const Elem* last);

Parameterwaarden

Koolstof
Het brede teken dat moet worden geconverteerd.

Wptr
De C-stijl, null-beëindigde reeks, beginnend bij wptr, die moet worden geconverteerd.

Wstr
De wide_string die moet worden geconverteerd.

eerste
Het eerste element in een reeks elementen die moeten worden geconverteerd.

laatste
Het laatste element in een reeks elementen die moeten worden geconverteerd.

Opmerkingen

Als het conversiestatusobjectniet is samengesteld met een expliciete waarde, wordt het ingesteld op de standaardwaarde (de initiële conversiestatus) voordat de conversie begint. Anders blijft het ongewijzigd.

Het aantal invoerelementen dat is geconverteerd, wordt opgeslagen in het conversieaantalobject. Als er geen conversiefout optreedt, retourneert de lidfunctie de geconverteerde bytetekenreeks. Als het object anders is samengesteld met een initialisatiefunctie voor het byte-tekenreeksfoutbericht, retourneert de lidfunctie het byte-tekenreeksfoutobject. Anders genereert de lidfunctie een object van klasse range_error.

wstring_convert::wide_string

Een type dat een brede tekenreeks vertegenwoordigt.

typedef std::basic_string<Elem> wide_string;

Opmerkingen

Het type is een synoniem voor std::basic_string<Elem>.

wstring_convert::wstring_convert

Maakt een object van het type wstring_convert.

wstring_convert(Codecvt *Pcvt = new Codecvt);
wstring_convert(Codecvt *Pcvt, state_type _State);
wstring_convert(const byte_string& _Berr, const wide_string& Werr = wide_string());

Parameterwaarden

*Pcvt
Het object van het type Codecvt om de conversie uit te voeren.

_Staat
Het object van het type state_type de conversiestatus aangeeft.

_Berr
De byte_string om weer te geven bij fouten.

Werr
De wide_string om weer te geven op fouten.

Opmerkingen

De eerste constructor slaat Pcvt_arg op in het conversieobject