Aracılığıyla paylaş

HString Sınıfı

  • Makale

RAII desenini kullanarak bir HSTRING'in ömrünü yönetmek için yardımcı sınıf.

Sözdizimi

class HString;

Açıklamalar

Windows Çalışma Zamanı, HSTRING tanıtıcıları aracılığıyla dizelere erişim sağlar. sınıfı, HString HSTRING tanıtıcılarını kullanmayı basitleştirmek için kolaylık işlevleri ve işleçleri sağlar. Bu sınıf, bir RAII deseni aracılığıyla sahip olduğu HSTRING'in ömrünü işleyebilir.

Üyeler

Ortak Oluşturucular

Adı Açıklama
HString::HString HString sınıfının yeni bir örneğini başlatır.
HString::~HString Sınıfının geçerli örneğini HString yok eder.

Genel Yöntemler

Adı Açıklama
HString::Attach Belirtilen HString nesneyi geçerli HString nesneyle ilişkilendirir.
HString::CopyTo Geçerli HString nesneyi bir HSTRING nesnesine kopyalar.
HString::D etach Belirtilen HString nesnenin temel alınan değeriyle ilişkilendirmesini kaldırır.
HString::Get Temel alınan HSTRING tanıtıcısının değerini alır.
HString::GetAddressOf Temel alınan HSTRING tutamacını gösteren bir işaretçi alır.
HString::GetRawBuffer Temel alınan dize verilerinin işaretçisini alır.
HString::IsValid Geçerli HString nesnenin geçerli olup olmadığını gösterir.
HString::MakeReference Belirtilen dize HStringReference parametresinden bir nesne oluşturur.
HString::Release Temel dize değerini siler ve geçerli HString nesneyi boş bir değere başlatır.
HString::Set Geçerli HString nesnenin değerini belirtilen geniş karakter dizesine veya HString parametresine ayarlar.

Ortak İşleçler

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

Devralma Hiyerarşisi

HString

Gereksinimler

Üst bilgi: corewrappers.h

Ad Alanı: Microsoft::WRL::Wrappers

HString::~HString

Sınıfının geçerli örneğini HString yok eder.

~HString() throw()

HString::Attach

Belirtilen HString nesneyi geçerli HString nesneyle ilişkilendirir.

void Attach(
       HSTRING hstr
       ) throw()

Parametreler

hstr
Varolan bir HString nesnesi.

HString::CopyTo

Geçerli HString 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.

HString::D etach

Belirtilen HString nesnenin temel alınan değeriyle ilişkilendirmesini kaldırır.

HSTRING Detach() throw()

İade Değeri

Ayırma işlemi başlatılmadan önceki temel HString değer.

HString::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 tutamacının değeri

HString::GetAddressOf

Temel alınan HSTRING tutamacını gösteren bir işaretçi alır.

HSTRING* GetAddressOf() throw()

İade Değeri

Temel alınan HSTRING tutamacını gösteren bir işaretçi.

Açıklamalar

Bu işlemden sonra, temel alınan HSTRING tanıtıcısının dize değeri yok edilir.

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

HString::HString

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

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

Parametreler

hstr
HSTRING tutamacı.

Diğer
Varolan bir HString nesnesi.

Açıklamalar

İlk oluşturucu boş olan yeni HString bir nesne başlatır.

İkinci oluşturucu, mevcut diğer parametrenin değerine yeni HString bir nesne başlatır ve ardından diğer parametreyi yok eder.

HString::IsValid

Geçerli HString nesnenin boş olup olmadığını gösterir.

bool IsValid() const throw()

Parametreler

true geçerli HString nesne boş değilse; değilse, false.

HString::MakeReference

Belirtilen dize HStringReference parametresinden bir nesne oluşturur.

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

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.

İade Değeri

HStringReference Değeri belirtilen str parametresiyle aynı olan bir nesne.

HString::operator= İşleci

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

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

Parametreler

Diğer
Varolan bir HString nesnesi.

Açıklamalar

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

HString::operator== İşleci

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

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

Parametreler

Lhs
Karşılaştıracak ilk parametre. lhs bir HString veya HStringReference nesnesi ya da HSTRING tutamacı olabilir.

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

İade Değeri

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

HString::operator!= İşleci

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

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

Parametreler

Lhs
Karşılaştıracak ilk parametre. lhs bir HString veya HStringReference nesnesi ya da HSTRING tutamacı olabilir.

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

İade Değeri

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

HString::operator< İşleci

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

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

Parametreler

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

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

İade Değeri

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

HString::Release

Temel dize değerini siler ve geçerli HString nesneyi boş bir değere atar.

void Release() throw()

HString::Set

Geçerli HString nesnenin değerini belirtilen geniş karakter dizesine veya HString parametresine ayarlar.

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

Parametreler

Str
Geniş karakterli bir dize.

Len
Geçerli HString nesneye atanan str parametresinin uzunluk üst sınırı.

hstr
Varolan bir HString nesnesi.