HStringReference – třída

Představuje HSTRING, který je vytvořen z existujícího řetězce.

Syntaxe

class HStringReference;

Poznámky

Životnost záložní vyrovnávací paměti v novém HSTRING není spravována prostředí Windows Runtime. Volající přidělí zdrojový řetězec v rámci zásobníku, aby se zabránilo přidělení haldy a eliminovalo riziko nevracení paměti. Volající také musí zajistit, aby zdrojový řetězec zůstal během životnosti připojeného HSTRING beze změny. Další informace naleznete v tématu WindowsCreateStringReference funkce.

Členové

Veřejné konstruktory

Název	Popis
HStringReference::HStringReference	Inicializuje novou instanci HStringReference třídy.

Veřejné metody

Člen	Popis
HStringReference::CopyTo	Zkopíruje aktuální HStringReference objekt do objektu HSTRING.
HStringReference::Get	Načte hodnotu podkladového popisovače HSTRING.
HStringReference::GetRawBuffer	Načte ukazatel na podkladová řetězcová data.

Veřejné operátory

Název	Popis
HStringReference::operator=	Přesune hodnotu jiného HStringReference objektu na aktuální HStringReference objekt.
HStringReference::operator==	Určuje, zda jsou oba parametry stejné.
HStringReference::operator!=	Určuje, jestli se oba parametry nerovnají.
HStringReference::operator<	Určuje, zda je první parametr menší než druhý parametr.

Hierarchie dědičnosti

HStringReference

Požadavky

Hlavička: corewrappers.h

Obor názvů: Microsoft::WRL::Wrappers

HStringReference::CopyTo

Zkopíruje aktuální HStringReference objekt do objektu HSTRING.

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

Parametry

Str
HSTRING, který obdrží kopii.

Poznámky

Tato metoda volá funkci WindowsDuplicateString .

HStringReference::Get

Načte hodnotu podkladového popisovače HSTRING.

HSTRING Get() const throw()

Návratová hodnota

Hodnota podkladového úchytu HSTRING.

HStringReference::GetRawBuffer

Načte ukazatel na podkladová řetězcová data.

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

Parametry

length Pointer to an int variable that receive the length of the data.

Návratová hodnota

const Ukazatel na podkladová řetězcová data.

HStringReference::HStringReference

Inicializuje novou instanci HStringReference třídy.

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

Parametry

sizeDest
Parametr šablony, který určuje velikost cílové HStringReference vyrovnávací paměti.

Str
Odkaz na řetězec širokého znaku.

Len
Maximální délka vyrovnávací paměti parametru str , která se má použít v této operaci. Pokud není zadaný parametr délka, použije se celý parametr str. Pokud je délka větší než velikostDest, je délka nastavena na velikostDest-1.

jiný
Jiný HStringReference objekt.

Poznámky

První konstruktor inicializuje nový HStringReference objekt, který má stejnou velikost jako parametr str.

Druhý konstruktor inicializuje nový HStringReference objekt, který velikost specifikifeid podle parametru len.

Třetí konstruktor inicializuje nový HStringReference objekt na hodnotu druhého parametru a pak zničí druhý parametr.

HStringReference::operator=

Přesune hodnotu jiného HStringReference objektu na aktuální HStringReference objekt.

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

Parametry

jiný
Existující objekt HStringReference.

Poznámky

Hodnota existujícího jiného objektu se zkopíruje do aktuálního HStringReference objektu a druhý objekt se zničí.

HStringReference::operator==

Určuje, zda jsou oba parametry stejné.

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

Parametry

Lhs
První parametr, který se má porovnat. lhs může být HStringReference objekt nebo úchyt HSTRING.

rhs
Druhý parametr, který se má porovnat. Rhs může být HStringReference objekt nebo úchyt HSTRING.

Návratová hodnota

truejsou-li parametry lhs a rhs stejné; jinak, false.

HStringReference::operator!=

Určuje, jestli se oba parametry nerovnají.

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

Parametry

Lhs
První parametr, který se má porovnat. lhs může být HStringReference objekt nebo úchyt HSTRING.

rhs
Druhý parametr, který se má porovnat. Rhs může být HStringReference objekt nebo úchyt HSTRING.

Návratová hodnota

truepokud parametry lhs a rhs nejsou stejné; jinak, false.

HStringReference::operator<

Určuje, zda je první parametr menší než druhý parametr.

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

Parametry

Lhs
První parametr, který se má porovnat. lhs může být odkaz na .HStringReference

rhs
Druhý parametr, který se má porovnat. rhs může být odkaz na .HStringReference

Návratová hodnota

truepokud je parametr lhs menší než parametr rhs; v opačném případě . false