Bagikan melalui

Kelas HString

  • Artikel

Kelas pembantu untuk mengelola masa pakai HSTRING menggunakan pola RAII.

Sintaks

class HString;

Keterangan

Windows Runtime menyediakan akses ke string melalui handel HSTRING . Kelas ini HString menyediakan fungsi dan operator kenyamanan untuk menyederhanakan penggunaan handel HSTRING. Kelas ini dapat menangani masa pakai HSTRING yang dimilikinya melalui pola RAII.

Anggota

Konstruktor Publik

Nama Deskripsi
HString::HString Menginisialisasi instans baru kelas HString.
HString::~HString Menghancurkan instans HString kelas saat ini.

Metode Publik

Nama Deskripsi
HString::Lampirkan Mengaitkan objek yang ditentukan HString dengan objek saat ini HString .
HString::CopyTo Menyalin objek saat ini HString ke objek HSTRING.
HString::D etach Memisahkan objek yang ditentukan HString dari nilai yang mendasarnya.
HString::Get Mengambil nilai handel HSTRING yang mendasar.
HString::GetAddressOf Mengambil penunjuk ke handel HSTRING yang mendasar.
HString::GetRawBuffer Mengambil penunjuk ke data string yang mendasar.
HString::IsValid Menunjukkan apakah objek saat ini HString valid.
HString::MakeReference HStringReference Membuat objek dari parameter string tertentu.
HString::Release Menghapus nilai string yang mendasar dan menginisialisasi objek saat ini HString ke nilai kosong.
HString::Set Mengatur nilai objek saat ini HString ke string atau HString parameter karakter lebar yang ditentukan.

Operator Publik

Nama Deskripsi
HString::operator= Memindahkan nilai objek lain HString ke objek saat ini HString .
HString::operator== Menunjukkan apakah kedua parameter sama.
HString::operator!= Menunjukkan apakah kedua parameter tidak sama.
HString::operator< Menunjukkan apakah parameter pertama kurang dari parameter kedua.

Hierarki Warisan

HString

Persyaratan

Header: corewrappers.h

Namespace: Microsoft::WRL::Wrappers

HString::~HString

Menghancurkan instans HString kelas saat ini.

~HString() throw()

HString::Lampirkan

Mengaitkan objek yang ditentukan HString dengan objek saat ini HString .

void Attach(
       HSTRING hstr
       ) throw()

Parameter

hstr
Objek yang HString sudah ada.

HString::CopyTo

Menyalin objek saat ini HString ke objek HSTRING.

HRESULT CopyTo(
   _Out_ HSTRING *str
   ) const throw();

Parameter

Str
HSTRING yang menerima salinan.

Keterangan

Metode ini memanggil fungsi WindowsDuplicateString .

HString::D etach

Memisahkan objek yang ditentukan HString dari nilai yang mendasarnya.

HSTRING Detach() throw()

Tampilkan Nilai

Nilai yang mendasar HString sebelum operasi lepaskan dimulai.

HString::Get

Mengambil nilai handel HSTRING yang mendasar.

HSTRING Get() const throw()

Tampilkan Nilai

Nilai handel HSTRING yang mendasar

HString::GetAddressOf

Mengambil penunjuk ke handel HSTRING yang mendasar.

HSTRING* GetAddressOf() throw()

Tampilkan Nilai

Penunjuk ke handel HSTRING yang mendasar.

Keterangan

Setelah operasi ini, nilai string dari handel HSTRING yang mendasar dihancurkan.

HString::GetRawBuffer

Mengambil penunjuk ke data string yang mendasar.

const wchar_t* GetRawBuffer(unsigned int* length) const;

Parameter

panjang Pointer ke int variabel yang menerima panjang data.

Tampilkan Nilai

const Penunjuk ke data string yang mendasar.

HString::HString

Menginisialisasi instans baru kelas HString.

HString() throw();
HString(HString&& other) throw();

Parameter

hstr
Handel HSTRING.

Lain
Objek yang HString sudah ada.

Keterangan

Konstruktor pertama menginisialisasi objek baru HString yang kosong.

Konstruktor kedua menginisialisasi objek baru HString ke nilai parameter lain yang ada, lalu menghancurkan parameter lainnya.

HString::IsValid

Menunjukkan apakah objek saat ini HString kosong atau tidak.

bool IsValid() const throw()

Parameter

true jika objek saat ini HString tidak kosong; jika tidak, false.

HString::MakeReference

HStringReference Membuat objek dari parameter string tertentu.

template<unsigned int sizeDest>
    static HStringReference MakeReference(
              wchar_t const (&str)[ sizeDest]);

    template<unsigned int sizeDest>
    static HStringReference MakeReference(
              wchar_t const (&str)[sizeDest],
              unsigned int len);

Parameter

sizeDest
Parameter templat yang menentukan ukuran buffer tujuan HStringReference .

Str
Referensi ke string karakter lebar.

Len
Panjang maksimum buffer parameter str untuk digunakan dalam operasi ini. Jika parameter lensa tidak ditentukan, seluruh parameter str akan digunakan.

Tampilkan Nilai

Objek HStringReference yang nilainya sama dengan parameter str yang ditentukan.

HString::operator= Operator

Memindahkan nilai objek lain HString ke objek saat ini HString .

HString& operator=(HString&& other) throw()

Parameter

Lain
Objek yang HString sudah ada.

Keterangan

Nilai objek lain yang ada disalin ke objek saat iniHString, lalu objek lainnya dihancurkan.

HString::operator== Operator

Menunjukkan apakah kedua parameter sama.

inline bool operator==(
               const HString& lhs,
               const HString& rhs) throw()

inline bool operator==(
                const HString& lhs,
                const HStringReference& rhs) throw()

inline bool operator==(
                const HStringReference& lhs,
                const HString& rhs) throw()

inline bool operator==(
                 const HSTRING& lhs,
                 const HString& rhs) throw()

inline bool operator==(
                 const HString& lhs,
                 const HSTRING& rhs) throw()

Parameter

Lhs
Parameter pertama yang akan dibandingkan. lhs bisa menjadi HString objek atau HStringReference , atau handel HSTRING.

rhs
Parameter kedua untuk dibandingkan.rhs dapat berupa HString objek atau HStringReference , atau handel HSTRING.

Tampilkan Nilai

truejika parameter lhs dan rhs sama; jika tidak, false.

HString::operator!= Operator

Menunjukkan apakah kedua parameter tidak sama.

inline bool operator!=( const HString& lhs,
                        const HString& rhs) throw()

inline bool operator!=( const HStringReference& lhs,
                        const HString& rhs) throw()

inline bool operator!=( const HString& lhs,
                        const HStringReference& rhs) throw()

inline bool operator!=( const HSTRING& lhs,
                        const HString& rhs) throw()

inline bool operator!=( const HString& lhs,
                        const HSTRING& rhs) throw()

Parameter

Lhs
Parameter pertama yang akan dibandingkan. lhs bisa menjadi HString objek atau HStringReference , atau handel HSTRING.

rhs
Parameter kedua untuk dibandingkan.rhs dapat berupa HString objek atau HStringReference , atau handel HSTRING.

Tampilkan Nilai

truejika parameter lhs dan rhs tidak sama; jika tidak, false.

HString::operator< Operator

Menunjukkan apakah parameter pertama kurang dari parameter kedua.

inline bool operator<(
    const HString& lhs,
    const HString& rhs) throw()

Parameter

Lhs
Parameter pertama yang akan dibandingkan. lhs dapat menjadi referensi ke HString.

rhs
Parameter kedua untuk dibandingkan. rhs dapat menjadi referensi ke HString.

Tampilkan Nilai

truejika parameter lhs kurang dari parameter rhs; jika tidak, false.

HString::Release

Menghapus nilai string yang mendasar dan mengintialisasi objek saat ini HString ke nilai kosong.

void Release() throw()

HString::Set

Mengatur nilai objek saat ini HString ke string atau HString parameter karakter lebar yang ditentukan.

HRESULT Set(
          const wchar_t* str) throw();
HRESULT Set(
          const wchar_t* str,
          unsigned int len
           ) throw();
HRESULT Set(
          const HSTRING& hstr
           ) throw();

Parameter

Str
String karakter lebar.

Len
Panjang maksimum parameter str yang ditetapkan ke objek saat ini HString .

hstr
Objek yang HString sudah ada.