Bagikan melalui

Kelas HStringReference

  • Artikel

Mewakili HSTRING yang dibuat dari string yang ada.

Sintaks

class HStringReference;

Keterangan

Masa pakai buffer dukungan di HSTRING baru tidak dikelola oleh Windows Runtime. Penelepon mengalokasikan string sumber pada bingkai tumpukan untuk menghindari alokasi tumpukan dan untuk menghilangkan risiko kebocoran memori. Selain itu, pemanggil harus memastikan bahwa string sumber tetap tidak berubah selama masa pakai HSTRING yang terpasang. Untuk informasi selengkapnya, lihat fungsi WindowsCreateStringReference.

Anggota

Konstruktor Publik

Nama Deskripsi
HStringReference::HStringReference Menginisialisasi instans baru kelas HStringReference.

Metode Publik

Anggota Deskripsi
HStringReference::CopyTo Menyalin objek saat ini HStringReference ke objek HSTRING.
HStringReference::Get Mengambil nilai handel HSTRING yang mendasar.
HStringReference::GetRawBuffer Mengambil penunjuk ke data string yang mendasar.

Operator Publik

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

Hierarki Warisan

HStringReference

Persyaratan

Header: corewrappers.h

Namespace: Microsoft::WRL::Wrappers

HStringReference::CopyTo

Menyalin objek saat ini HStringReference ke objek HSTRING.

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

Parameter

Str
HSTRING yang menerima salinan.

Keterangan

Metode ini memanggil fungsi WindowsDuplicateString .

HStringReference::Get

Mengambil nilai handel HSTRING yang mendasar.

HSTRING Get() const throw()

Tampilkan Nilai

Nilai handel HSTRING yang mendasar.

HStringReference::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.

HStringReference::HStringReference

Menginisialisasi instans baru kelas HStringReference.

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

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

HStringReference(HStringReference&& other) throw();

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. Jika lensa lebih besar dari sizeDest, lensa diatur ke sizeDest-1.

lain
Objek lain HStringReference .

Keterangan

Konstruktor pertama menginisialisasi objek baru HStringReference dengan ukuran yang sama dengan parameter str.

Konstruktor kedua menginisialisasi objek baru HStringReference yang ukuran specifeid menurut lensa parameter.

Konstruktor ketiga menginisialisasi objek baru HStringReference ke nilai parameter lain , lalu menghancurkan parameter lainnya .

HStringReference::operator=

Memindahkan nilai objek lain HStringReference ke objek saat ini HStringReference .

HStringReference& operator=(HStringReference&& other) throw()

Parameter

lain
Objek yang HStringReference sudah ada.

Keterangan

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

HStringReference::operator==

Menunjukkan apakah kedua parameter sama.

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

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

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

Parameter

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

rhs
Parameter kedua untuk dibandingkan. rhs dapat menjadi HStringReference objek atau handel HSTRING.

Tampilkan Nilai

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

HStringReference::operator!=

Menunjukkan apakah kedua parameter tidak sama.

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

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

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

Parameter

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

rhs
Parameter kedua untuk dibandingkan. rhs dapat menjadi HStringReference objek atau handel HSTRING.

Tampilkan Nilai

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

HStringReference::operator<

Menunjukkan apakah parameter pertama kurang dari parameter kedua.

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

Parameter

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

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

Tampilkan Nilai

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