次の方法で共有

HStringReference クラス

  • [アーティクル]

既存の文字列から作成された HSTRING を表します。

構文

class HStringReference;

解説

新しい HSTRING のバッキング バッファーの有効期間は、Windows ランタイムでは管理されていません。 呼び出し元はソース文字列をスタック フレームに割り当てることで、ヒープ割り当てを回避し、メモリ リークのリスクを排除します。 また、呼び出し元はアタッチ済みの HSTRING の有効期間中にソース文字列が変更されないことを確認する必要があります。 詳細については、WindowsCreateStringReference 関数に関する記事を参照してください。

メンバー

パブリック コンストラクター

名前 説明
HStringReference::HStringReference HStringReference クラスの新しいインスタンスを初期化します。

パブリック メソッド

メンバー 説明
HStringReference::CopyTo 現在の HStringReference オブジェクトを HSTRING オブジェクトにコピーします。
HStringReference::Get 基になる HSTRING ハンドルの値を取得します。
HStringReference::GetRawBuffer 基になる文字列データへのポインターを取得します。

パブリック演算子

名前 説明
HStringReference::operator= 別の HStringReference オブジェクトの値を現在の HStringReference オブジェクトに移動します。
HStringReference::operator== 2 つのパラメーターが等しいかどうかを示します。
HStringReference::operator!= 2 つのパラメーターが異なるかどうかを示します。
HStringReference::operator< 1 つ目のパラメーターが 2 つ目のパラメーターより小さいかどうかを示します。

継承階層

HStringReference

必要条件

ヘッダー: corewrappers.h

名前空間: Microsoft::WRL::Wrappers

HStringReference::CopyTo

現在の HStringReference オブジェクトを HSTRING オブジェクトにコピーします。

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

パラメーター

str
コピーを受信する HSTRING です。

解説

このメソッドを使用すると WindowsDuplicateString 関数が呼び出されます。

HStringReference::Get

基になる HSTRING ハンドルの値を取得します。

HSTRING Get() const throw()

戻り値

基になる HSTRING ハンドルの値。

HStringReference::GetRawBuffer

基になる文字列データへのポインターを取得します。

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

パラメーター

length データの長さを受け取る int 変数へのポインター。

戻り値

基になる文字列データへの const ポインター。

HStringReference::HStringReference

HStringReference クラスの新しいインスタンスを初期化します。

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

パラメーター

sizeDest
宛先 HStringReference バッファーのサイズを指定するテンプレート パラメーター。

str
ワイド文字の文字列への参照。

len
この操作で使用する str パラメーター バッファーの最大長。 len パラメーターが指定されていない場合は、str パラメーター全体が使用されます。 len が sizeDest より大きい場合、len は sizeDest-1 に設定されます。

other
別の HStringReference オブジェクト。

解説

最初のコンストラクターにより、パラメーター str と同じサイズの新しい HStringReference オブジェクトが初期化されます。

2 番目のコンストラクターにより、パラメーター len で指定されたサイズの新しい HStringReference オブジェクトが初期化されます。

3 番目のコンストラクターにより、新しい HStringReference オブジェクトが other パラメーターの値に初期化されてから、other パラメーターが破棄されます。

HStringReference::operator=

別の HStringReference オブジェクトの値を現在の HStringReference オブジェクトに移動します。

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

パラメーター

other
既存の HStringReference オブジェクトです。

解説

既存の other オブジェクトの値が現在の HStringReference オブジェクトにコピーされてから、other オブジェクトが破棄されます。

HStringReference::operator==

2 つのパラメーターが等しいかどうかを示します。

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

パラメーター

Lhs
比較する最初のパラメーター。 lhs は HStringReference オブジェクトか、HSTRING ハンドルにすることができます。

rhs
比較する 2 番目のパラメーター。 rhs は HStringReference オブジェクトか、HSTRING ハンドルにすることができます。

戻り値

lhs パラメーターと rhs パラメーターが等しい場合は true。それ以外の場合は false。

HStringReference::operator!=

2 つのパラメーターが異なるかどうかを示します。

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

パラメーター

Lhs
比較する最初のパラメーター。 lhs は HStringReference オブジェクトか、HSTRING ハンドルにすることができます。

rhs
比較する 2 番目のパラメーター。 rhs は HStringReference オブジェクトか、HSTRING ハンドルにすることができます。

戻り値

lhs パラメーターと rhs パラメーターが等しくない場合は true。それ以外の場合は false。

HStringReference::operator<

1 つ目のパラメーターが 2 つ目のパラメーターより小さいかどうかを示します。

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

パラメーター

Lhs
比較する最初のパラメーター。 lhs は、HStringReference の参照にすることができます。

rhs
比較する 2 番目のパラメーター。 rhs は、HStringReference の参照にすることができます。

戻り値

lhs パラメーターが rhs パラメーターより小さい場合は true。それ以外の場合は false。