Megosztás a következőn keresztül:

HString osztály

Segédosztály a HSTRING élettartamának kezelésére a RAII-minta használatával.

Szemantika

class HString;

Megjegyzések

A Windows futtatókörnyezet a HSTRING-leírókon keresztül biztosít hozzáférést a sztringekhez . Az HString osztály kényelmi funkciókat és operátorokat biztosít a HSTRING-leírók használatának egyszerűsítése érdekében. Ez az osztály egy RAII-mintán keresztül képes kezelni a tulajdonában lévő HSTRING élettartamát.

Members

Nyilvános konstruktorok

Név Description
HString::HString Inicializálja az osztály új példányát HString .
HString::~HString Megsemmisíti az osztály aktuális példányát HString .

Nyilvános metódusok

Név Description
HString::Csatolás A megadott HString objektumot az aktuális HString objektumhoz társítja.
HString::CopyTo Másolja az aktuális HString objektumot egy HSTRING objektumba.
HString::D etach Leválasztja a megadott HString objektumot a mögöttes értékről.
HString::Get Lekéri a mögöttes HSTRING-leíró értékét.
HString::GetAddressOf Az alapul szolgáló HSTRING-leíróra mutató mutatót kér le.
HString::GetRawBuffer A mögöttes sztringadatokra mutató mutatót kér le.
HString::IsValid Azt jelzi, hogy az aktuális HString objektum érvényes-e.
HString::MakeReference Objektumot HStringReference hoz létre egy megadott sztringparaméterből.
HString::Release Törli a mögöttes sztringértéket, és inicializálja az aktuális HString objektumot egy üres értékre.
HString::Set Az aktuális HString objektum értékét a megadott széles karakterű sztringre vagy HString paraméterre állítja.

Nyilvános operátorok

Név Description
HString::operator= Áthelyezi egy másik HString objektum értékét az aktuális HString objektumba.
HString::operator== Azt jelzi, hogy a két paraméter egyenlő-e.
HString::operátor!= Azt jelzi, hogy a két paraméter nem egyenlő-e.
HString::operator< Azt jelzi, hogy az első paraméter kisebb-e, mint a második paraméter.

Öröklési hierarchia

HString

Requirements

Fejléc: corewrappers.h

Namespace: Microsoft::WRL::Burkolók

HString::~HString

Megsemmisíti az osztály aktuális példányát HString .

~HString() throw()

HString::Csatolás

A megadott HString objektumot az aktuális HString objektumhoz társítja.

void Attach(
       HSTRING hstr
       ) throw()

Paraméterek

hstr
Egy meglévő HString objektum.

HString::CopyTo

Másolja az aktuális HString objektumot egy HSTRING objektumba.

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

Paraméterek

Str
A másolatot fogadó HSTRING.

Megjegyzések

Ez a metódus meghívja a WindowsDuplicateString függvényt .

HString::D etach

Leválasztja a megadott HString objektumot a mögöttes értékről.

HSTRING Detach() throw()

Visszaadott érték

A leválasztási művelet megkezdése előtti mögöttes HString érték.

HString::Get

Lekéri a mögöttes HSTRING-leíró értékét.

HSTRING Get() const throw()

Visszaadott érték

A mögöttes HSTRING-leíró értéke

HString::GetAddressOf

Az alapul szolgáló HSTRING-leíróra mutató mutatót kér le.

HSTRING* GetAddressOf() throw()

Visszaadott érték

A mögöttes HSTRING-leíróra mutató mutató.

Megjegyzések

A művelet után a mögöttes HSTRING-leíró sztringértéke el lesz pusztítva.

HString::GetRawBuffer

A mögöttes sztringadatokra mutató mutatót kér le.

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

Paraméterek

hosszúság Mutasson egy int olyan változóra, amely megkapja az adatok hosszát.

Visszaadott érték

A const mögöttes sztringadatokra mutató mutató.

HString::HString

Inicializálja az osztály új példányát HString .

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

Paraméterek

hstr
HSTRING fogópont.

más
Egy meglévő HString objektum.

Megjegyzések

Az első konstruktor inicializál egy üres új HString objektumot.

A második konstruktor inicializál egy új HString objektumot a meglévő másik paraméter értékére, majd megsemmisíti a másik paramétert.

HString::IsValid

Azt jelzi, hogy az aktuális HString objektum üres-e vagy sem.

bool IsValid() const throw()

Paraméterek

true ha az aktuális HString objektum nem üres; falseellenkező esetben.

HString::MakeReference

Objektumot HStringReference hoz létre egy megadott sztringparaméterből.

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

Paraméterek

sizeDest
A célpuffer HStringReference méretét meghatározó sablonparaméter.

Str
Hivatkozás széles karakterű sztringre.

len
A művelethez használandó str paraméterpuffer maximális hossza. Ha a len paraméter nincs megadva, a rendszer a teljes str paramétert használja.

Visszaadott érték

Olyan HStringReference objektum, amelynek értéke megegyezik a megadott str paraméterével.

HString::operator= Operátor

Áthelyezi egy másik HString objektum értékét az aktuális HString objektumba.

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

Paraméterek

más
Egy meglévő HString objektum.

Megjegyzések

A meglévő másik objektum értékét a rendszer az aktuális HString objektumba másolja, majd a másik objektumot megsemmisíti.

HString::operator== Operátor

Azt jelzi, hogy a két paraméter egyenlő-e.

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

Paraméterek

Lhs
Az első összehasonlítandó paraméter. Az lhs lehet egy vagy HStringReference objektumHString, vagy HSTRING-leíró.

rhs
A második összehasonlítandó paraméter. rhs lehet egy vagy HStringReference objektumHString, vagy egy HSTRING fogópont.

Visszaadott érték

trueha az lhs és rhs paraméterek egyenlőek; egyéb esetben. false

HString::operátor!= Operátor

Azt jelzi, hogy a két paraméter nem egyenlő-e.

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

Paraméterek

Lhs
Az első összehasonlítandó paraméter. Az lhs lehet egy vagy HStringReference objektumHString, vagy HSTRING-leíró.

rhs
A második összehasonlítandó paraméter. rhs lehet egy vagy HStringReference objektumHString, vagy egy HSTRING fogópont.

Visszaadott érték

trueha az lhs és rhs paraméterek nem egyenlők; egyéb esetben. false

HString::operator< Operátor

Azt jelzi, hogy az első paraméter kisebb-e, mint a második paraméter.

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

Paraméterek

Lhs
Az első összehasonlítandó paraméter. Az lhs lehet egy hivatkozás egy HString.

rhs
A második összehasonlítandó paraméter. rhs lehet egy hivatkozás egy HString.

Visszaadott érték

trueha az lhs paraméter kisebb, mint az rhs paraméter; egyéb esetben. false

HString::Release

Törli a mögöttes sztringértéket, és inicializálja az aktuális HString objektumot egy üres értékre.

void Release() throw()

HString::Set

Az aktuális HString objektum értékét a megadott széles karakterű sztringre vagy HString paraméterre állítja.

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

Paraméterek

Str
Széles karakterű sztring.

len
Az aktuális HString objektumhoz rendelt str paraméter maximális hossza.

hstr
Egy meglévő HString objektum.

  • Last updated on