Aracılığıyla paylaş


wstring_convert Sınıfı

Sınıf şablonu wstring_convert geniş bir dize ile bayt dizesi arasında dönüştürmeler gerçekleştirir.

Sözdizimi

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

Parametreler

Codecvt
Dönüştürme nesnesini temsil eden yerel ayar model.

Elem
Geniş karakterli öğe türü.

Açıklamalar

Sınıf şablonu, sınıfın geniş dize nesneleri ile sınıfın std::basic_string<Elem> bayt dizesi nesneleri std::basic_string<char> (olarak std::stringda bilinir) arasındaki dönüştürmeleri denetleen bir nesneyi açıklar. Sınıf şablonu, ve byte_string türlerini bu iki türün wide_string eş anlamlıları olarak tanımlar. Bir değer dizisi Elem (bir wide_string nesnede depolanır) ve çok baytlı diziler (bir byte_string nesnede depolanır) arasında dönüştürme, standart kod dönüştürme modelinin std::codecvt<Elem, char, std::mbstate_t>gereksinimlerini karşılayan sınıfının Codecvt<Elem, char, std::mbstate_t>bir nesnesi tarafından gerçekleştirilir.

Bu sınıf şablonunun bir nesnesi depolar:

  • Hatalarda görüntülenecek bayt dizesi

  • Hatalarda görüntülenecek geniş bir dize

  • Ayrılmış dönüştürme nesnesinin işaretçisi (wbuffer_convert nesnesi yok edildiğinde serbesttir)

  • state_type türünde bir dönüştürme durumu nesnesi

  • Dönüştürme sayısı

Oluşturucular

Oluşturucu Tanım
wstring_convert türünde wstring_convertbir nesnesi oluşturur.

Tür tanımları

Tür adı Tanım
byte_string Bayt dizesini temsil eden bir tür.
wide_string Geniş bir dizeyi temsil eden bir tür.
state_type Dönüştürme durumunu temsil eden bir tür.
Int_type Tamsayıyı temsil eden bir tür.

Üye işlevleri

Üye işlevi Tanım
from_bytes Bayt dizesini geniş bir dizeye dönüştürür.
to_bytes Geniş bir dizeyi bayt dizesine dönüştürür.
Dönüştürülmüş Başarılı dönüştürmelerin sayısını döndürür.
state Dönüştürmenin durumunu temsil eden bir nesne döndürür.

Gereksinimler

Üst bilgi:<yerel ayar>

Ad alanı: std

wstring_convert::byte_string

Bayt dizesini temsil eden bir tür.

typedef std::basic_string<char> byte_string;

Açıklamalar

türü, için std::basic_string<char>bir eş anlamlıdır.

wstring_convert::converted

Başarılı dönüştürmelerin sayısını döndürür.

size_t converted() const;

İade Değeri

Başarılı dönüştürmelerin sayısı.

Açıklamalar

Başarılı dönüştürme sayısı, dönüştürme sayısı nesnesinde depolanır.

wstring_convert::from_bytes

Bayt dizesini geniş bir dizeye dönüştürür.

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);

Parametreler

Bayt
Dönüştürülecek tek öğeli bayt dizisi.

ptr
Dönüştürülecek C stili, null olarak sonlandırılan karakter dizisi.

Bstr
Dönüştürülecek byte_string .

Ilk
Dönüştürülecek karakter aralığındaki ilk karakter.

Son
Dönüştürülecek karakter aralığındaki son karakter.

İade Değeri

Dönüştürmeden kaynaklanan geniş bir dize nesnesi.

Açıklamalar

Dönüştürme durumu nesnesi açık bir değerle oluşturulmazsa, dönüştürme başlamadan önce varsayılan değerine (ilk dönüştürme durumu) ayarlanır. Aksi takdirde değişmeden bırakılır.

Başarıyla dönüştürülen giriş öğelerinin sayısı dönüştürme sayısı nesnesinde depolanır. Dönüştürme hatası oluşmazsa, üye işlevi dönüştürülmüş geniş dizeyi döndürür. Aksi takdirde, nesne geniş dize hata iletisi için bir başlatıcı ile oluşturulduysa, üye işlevi geniş dize hata iletisi nesnesini döndürür. Aksi takdirde, üye işlevi sınıf range_error bir nesnesi oluşturur.

wstring_convert::int_type

Tamsayıyı temsil eden bir tür.

typedef typename wide_string::traits_type::int_type int_type;

Açıklamalar

türü, için wide_string::traits_type::int_typebir eş anlamlıdır.

wstring_convert::state

Dönüştürmenin durumunu temsil eden bir nesne döndürür.

state_type state() const;

İade Değeri

Dönüştürmenin durumunu temsil eden dönüştürme durumu nesnesi.

Açıklamalar

wstring_convert::state_type

Dönüştürme durumunu temsil eden bir tür.

typedef typename Codecvt::state_type state_type;

Açıklamalar

Türü, dönüştürme durumunu temsil eden bir nesneyi açıklar. türü, için Codecvt::state_typebir eş anlamlıdır.

wstring_convert::to_bytes

Geniş bir dizeyi bayt dizesine dönüştürür.

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);

Parametreler

Char
Dönüştürülecek geniş karakter.

Wptr
dönüştürülecek olan C stili, null ile sonlandırılan, konumundan wptrbaşlayarak dizisi.

Wstr
Dönüştürülecek wide_string .

Ilk
Dönüştürülecek öğe aralığındaki ilk öğe.

Son
Dönüştürülecek öğe aralığındaki son öğe.

Açıklamalar

Dönüştürme durumu nesnesi açık bir değerle oluşturulmazsa, dönüştürme başlamadan önce varsayılan değerine (ilk dönüştürme durumu) ayarlanır. Aksi takdirde değişmeden bırakılır.

Başarıyla dönüştürülen giriş öğelerinin sayısı dönüştürme sayısı nesnesinde depolanır. Dönüştürme hatası oluşmazsa, üye işlevi dönüştürülmüş bayt dizesini döndürür. Aksi takdirde, nesne bayt dizesi hata iletisi için bir başlatıcı ile oluşturulduysa, üye işlevi bayt dizesi hata iletisi nesnesini döndürür. Aksi takdirde, üye işlevi sınıf range_error bir nesnesi oluşturur.

wstring_convert::wide_string

Geniş bir dizeyi temsil eden bir tür.

typedef std::basic_string<Elem> wide_string;

Açıklamalar

türü, için std::basic_string<Elem>bir eş anlamlıdır.

wstring_convert::wstring_convert

türünde wstring_convertbir nesnesi oluşturur.

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());

Parametreler

*Pcvt
Dönüştürmeyi gerçekleştirmek için türündeki Codecvt nesnesi.

_Durum
türündeki nesne, dönüştürme durumunu temsil eden state_type .

_Berr
Hatalarda görüntülenecek byte_string.

Werr
Hatalarda görüntülenecek wide_string.

Açıklamalar

İlk oluşturucu dönüştürme nesnesinde Pcvt_arg depolar