HStringReference Sınıfı

Mevcut bir dizeden oluşturulan bir HSTRING'i temsil eder.

Sözdizimi

class HStringReference;

Açıklamalar

Yeni HSTRING'deki yedekleme arabelleğinin ömrü Windows Çalışma Zamanı tarafından yönetilmiyor. Çağıran, yığın ayırmayı önlemek ve bellek sızıntısı riskini ortadan kaldırmak için yığın çerçevesinde bir kaynak dize ayırır. Ayrıca, çağıranın ekli HSTRING'in ömrü boyunca kaynak dizenin değişmeden kaldığından emin olması gerekir. Daha fazla bilgi için bkz . WindowsCreateStringReference işlevi.

Üyeler

Ortak Oluşturucular

Ad	Tanım
HStringReference::HStringReference	HStringReference sınıfının yeni bir örneğini başlatır.

Genel Yöntemler

Üye	Tanım
HStringReference::CopyTo	Geçerli HStringReference nesneyi bir HSTRING nesnesine kopyalar.
HStringReference::Get	Temel alınan HSTRING tanıtıcısının değerini alır.
HStringReference::GetRawBuffer	Temel alınan dize verilerinin işaretçisini alır.

Ortak İşleçler

Ad	Tanım
HStringReference::operator=	Başka bir HStringReference nesnenin değerini geçerli HStringReference nesneye taşır.
HStringReference::operator==	İki parametrenin eşit olup olmadığını gösterir.
HStringReference::operator!=	İki parametrenin eşit olup olmadığını gösterir.
HStringReference::operator<	İlk parametrenin ikinci parametreden küçük olup olmadığını gösterir.

Devralma Hiyerarşisi

HStringReference

Gereksinimler

Üst bilgi: corewrappers.h

Ad Alanı: Microsoft::WRL::Wrappers

HStringReference::CopyTo

Geçerli HStringReference nesneyi bir HSTRING nesnesine kopyalar.

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

Parametreler

Str
Kopyayı alan HSTRING.

Açıklamalar

Bu yöntem WindowsDuplicateString işlevini çağırır.

HStringReference::Get

Temel alınan HSTRING tanıtıcısının değerini alır.

HSTRING Get() const throw()

İade Değeri

Temel alınan HSTRING tanıtıcısının değeri.

HStringReference::GetRawBuffer

Temel alınan dize verilerinin işaretçisini alır.

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

Parametreler

uzunluk Veri uzunluğunu alan bir int değişkenin işaretçisi.

İade Değeri

const Temel alınan dize verilerinin işaretçisi.

HStringReference::HStringReference

HStringReference sınıfının yeni bir örneğini başlatır.

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

Parametreler

sizeDest
Hedef HStringReference arabelleğin boyutunu belirten bir şablon parametresi.

Str
Geniş karakterli bir dizeye başvuru.

Len
Bu işlemde kullanılacak str parametresi arabelleğinin uzunluk üst sınırı. Uzunluk parametresi belirtilmezse str parametresinin tamamı kullanılır. Uzunluk sizeDest değerinden büyükse uzunluk,sizeDest-1 olarak ayarlanır.

Diğer
Başka bir HStringReference nesne.

Açıklamalar

İlk oluşturucu, parametre str ile aynı boyutta yeni HStringReference bir nesne başlatır.

İkinci oluşturucu, boyutun uzunluk parametresine göre belirtimini gösteren yeni HStringReference bir nesne başlatır.

Üçüncü oluşturucu, diğer parametrenin değerine yeni HStringReference bir nesne başlatır ve ardından diğer parametreyi yok eder.

HStringReference::operator=

Başka bir HStringReference nesnenin değerini geçerli HStringReference nesneye taşır.

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

Parametreler

Diğer
Varolan bir HStringReference nesnesi.

Açıklamalar

Mevcut diğer nesnenin değeri geçerli HStringReference nesneye kopyalanır ve ardından diğer nesne yok edilir.

HStringReference::operator==

İki parametrenin eşit olup olmadığını gösterir.

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

Parametreler

Lhs
Karşılaştıracak ilk parametre. lhs bir HStringReference nesne veya HSTRING tutamacı olabilir.

Rhs
Karşılaştıracak ikinci parametre. rhs bir HStringReference nesne veya HSTRING tutamacı olabilir.

İade Değeri

truelhs ve rhs parametreleri eşitse; eşit değilse, false.

HStringReference::operator!=

İki parametrenin eşit olup olmadığını gösterir.

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

Parametreler

Lhs
Karşılaştıracak ilk parametre. lhs bir HStringReference nesne veya HSTRING tutamacı olabilir.

Rhs
Karşılaştıracak ikinci parametre. rhs bir HStringReference nesne veya HSTRING tutamacı olabilir.

İade Değeri

truelhs ve rhs parametreleri eşit değilse, değilse, false.

HStringReference::operator<

İlk parametrenin ikinci parametreden küçük olup olmadığını gösterir.

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

Parametreler

Lhs
Karşılaştıracak ilk parametre. lhs , bir HStringReferenceöğesine başvuru olabilir.

Rhs
Karşılaştıracak ikinci parametre. rhs , bir HStringReferenceöğesine başvuru olabilir.

İade Değeri

truelhs parametresi rhs parametresinden küçükse, değilse, false.