HString-klasse

Een helperklasse voor het beheren van de levensduur van een HSTRING met behulp van het RAII-patroon.

Syntaxis

class HString;

Opmerkingen

Windows Runtime biedt toegang tot tekenreeksen via HSTRING-ingangen . De HString klasse biedt handige functies en operators om het gebruik van HSTRING-ingangen te vereenvoudigen. Deze klasse kan de levensduur van de HSTRING verwerken waarvan deze eigenaar is via een RAII-patroon.

Members

Openbare constructors

Naam	Description
HString::HString	Initialiseert een nieuw exemplaar van de HString klasse.
HString::~HString	Vernietigt het huidige exemplaar van de HString klasse.

Openbare methoden

Naam	Description
HString::Attach	Hiermee koppelt u het opgegeven HString object aan het huidige HString object.
HString::CopyTo	Hiermee kopieert u het huidige HString object naar een HSTRING-object.
HString::D etach	Koppelt het opgegeven HString object los van de onderliggende waarde.
HString::Get	Haalt de waarde van de onderliggende HSTRING-ingang op.
HString::GetAddressOf	Hiermee wordt een aanwijzer opgehaald naar de onderliggende HSTRING-ingang.
HString::GetRawBuffer	Hiermee haalt u een aanwijzer op naar de onderliggende tekenreeksgegevens.
HString::IsValid	Geeft aan of het huidige HString object geldig is.
HString::MakeReference	Hiermee maakt u een HStringReference object op basis van een opgegeven tekenreeksparameter.
HString::Release	Hiermee verwijdert u de onderliggende tekenreekswaarde en initialiseert u het huidige HString object in een lege waarde.
HString::Set	Hiermee stelt u de waarde van het huidige HString object in op de opgegeven tekenreeks of HString parameter voor breedtekens.

Openbare operators

Naam	Description
HString::operator=	Hiermee verplaatst u de waarde van een ander HString object naar het huidige HString object.
HString::operator==	Geeft aan of de twee parameters gelijk zijn.
HString::operator!=	Geeft aan of de twee parameters niet gelijk zijn.
HString::operator<	Geeft aan of de eerste parameter kleiner is dan de tweede parameter.

Overnamehiërarchie

HString

Requirements

Koptekst: corewrappers.h

Namespace: Microsoft::WRL::Wrappers

HString::~HString

Vernietigt het huidige exemplaar van de HString klasse.

~HString() throw()

HString::Attach

Hiermee koppelt u het opgegeven HString object aan het huidige HString object.

void Attach(
       HSTRING hstr
       ) throw()

Parameterwaarden

hstr
Een bestaand HString object.

HString::CopyTo

Hiermee kopieert u het huidige HString object naar een HSTRING-object.

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

Parameterwaarden

Str
De HSTRING die de kopie ontvangt.

Opmerkingen

Met deze methode wordt de functie WindowsDuplicateString aangeroepen.

HString::D etach

Koppelt het opgegeven HString object los van de onderliggende waarde.

HSTRING Detach() throw()

Retourwaarde

De onderliggende HString waarde voordat de loskoppelbewerking is gestart.

HString::Get

Haalt de waarde van de onderliggende HSTRING-ingang op.

HSTRING Get() const throw()

Retourwaarde

De waarde van de onderliggende HSTRING-ingang

HString::GetAddressOf

Hiermee wordt een aanwijzer opgehaald naar de onderliggende HSTRING-ingang.

HSTRING* GetAddressOf() throw()

Retourwaarde

Een aanwijzer naar de onderliggende HSTRING-ingang.

Opmerkingen

Na deze bewerking wordt de tekenreekswaarde van de onderliggende HSTRING-ingang vernietigd.

HString::GetRawBuffer

Hiermee haalt u een aanwijzer op naar de onderliggende tekenreeksgegevens.

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

Parameterwaarden

lengte Wijs een int variabele aan die de lengte van de gegevens ontvangt.

Retourwaarde

Een const aanwijzer naar de onderliggende tekenreeksgegevens.

HString::HString

Initialiseert een nieuw exemplaar van de HString klasse.

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

Parameterwaarden

hstr
Een HSTRING-greep.

ander
Een bestaand HString object.

Opmerkingen

De eerste constructor initialiseert een nieuw HString object dat leeg is.

De tweede constructor initialiseert een nieuw HString object naar de waarde van de bestaande andere parameter en vernietigt vervolgens de andere parameter.

HString::IsValid

Geeft aan of het huidige HString object leeg is of niet.

bool IsValid() const throw()

Parameterwaarden

trueals het huidige HString object niet leeg is; anders. false

HString::MakeReference

Hiermee maakt u een HStringReference object op basis van een opgegeven tekenreeksparameter.

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

Parameterwaarden

sizeDest
Een sjabloonparameter die de grootte van de doelbuffer HStringReference aangeeft.

Str
Een verwijzing naar een tekenreeks met een breed teken.

Len
De maximale lengte van de str-parameterbuffer die in deze bewerking moet worden gebruikt. Als de parameter len niet is opgegeven, wordt de parameter hele str gebruikt.

Retourwaarde

Een HStringReference object waarvan de waarde hetzelfde is als de opgegeven str-parameter .

HString::operator= Operator

Hiermee verplaatst u de waarde van een ander HString object naar het huidige HString object.

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

Parameterwaarden

ander
Een bestaand HString object.

Opmerkingen

De waarde van het bestaande andere object wordt gekopieerd naar het huidige HString object en vervolgens wordt het andere object vernietigd.

HString::operator== Operator

Geeft aan of de twee parameters gelijk zijn.

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

Parameterwaarden

Lhs
De eerste parameter die moet worden vergeleken. lhs kan een HString of HStringReference object of een HSTRING-greep zijn.

Rhs
De tweede parameter die moet worden vergeleken. rhs kan een HString of object of HStringReference een HSTRING-greep zijn.

Retourwaarde

true indien de parameters voor lhs en rhs gelijk zijn; anders, false.

HString::operator!= Operator

Geeft aan of de twee parameters niet gelijk zijn.

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

Parameterwaarden

Lhs
De eerste parameter die moet worden vergeleken. lhs kan een HString of HStringReference object of een HSTRING-greep zijn.

Rhs
De tweede parameter die moet worden vergeleken. rhs kan een HString of object of HStringReference een HSTRING-greep zijn.

Retourwaarde

true indien de parameters voor lhs en rhs niet gelijk zijn; anders, false.

HString::operator< Bediener

Geeft aan of de eerste parameter kleiner is dan de tweede parameter.

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

Parameterwaarden

Lhs
De eerste parameter die moet worden vergeleken. lhs kan een verwijzing naar een HString.

Rhs
De tweede parameter die moet worden vergeleken. rhs kan een verwijzing naar een HString.

Retourwaarde

true als de parameter lhs kleiner is dan de rhs-parameter ; anders, false.

HString::Release

Hiermee verwijdert u de onderliggende tekenreekswaarde en initialiseert u het huidige HString object in een lege waarde.

void Release() throw()

HString::Set

Hiermee stelt u de waarde van het huidige HString object in op de opgegeven tekenreeks of HString parameter voor breedtekens.

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

Parameterwaarden

Str
Een tekenreeks met een breed teken.

Len
De maximale lengte van de str-parameter die is toegewezen aan het huidige HString object.

hstr
Een bestaand HString object.