Platform::StringReference クラス

  • [アーティクル]

最小のコピー操作で Platform::String^ 入力パラメーターから他のメソッドに文字列データを渡すために使用できる最適化の手法です。

構文

class StringReference

解説

メンバー

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

名前 説明
StringReference::StringReference StringReferenceのインスタンスを作成するための 2 つのコンストラクター。

パブリック メソッド

名前 説明
StringReference::Data 文字列データを char16 値の配列として返します。
StringReference::Length 文字列内の文字数を返します。
StringReference::GetHSTRING 文字列データを HSTRING として返します。
StringReference::GetString 文字列データを Platform::String^として返します。

パブリック演算子

名前 説明
StringReference::operator= StringReference を新しい StringReference インスタンスに割り当てます。
StringReference::operator() StringReference を Platform::String^に変換します。

必要条件

サポートされている最低限のクライアント: Windows 8

サポートされている最低限のサーバー: Windows Server 2012

名前空間: Platform

ヘッダー: vccorlib.h

StringReference::Data メソッド

この StringReference のコンテンツを char16 値の配列として返します。

構文

const ::default::char16 * Data() const;

戻り値

char16 UNICODE テキスト文字の配列。

StringReference::GetHSTRING メソッド

__abi_HSTRING として文字列の内容を返します。

構文

__abi_HSTRING GetHSTRING() const;

戻り値

文字列データを格納する __abi_HSTRING。

解説

StringReference::GetString メソッド

Platform::String^ として文字列の内容を返します。

構文

__declspec(no_release_return) __declspec(no_refcount)
    ::Platform::String^ GetString() const;

戻り値

文字列データを格納する Platform::String^。

StringReference::Length メソッド

文字列内の文字数を返します。

構文

unsigned int Length() const;

戻り値

文字列の文字数を指定する符号なし整数。

解説

StringReference::operator= 演算子

指定されたオブジェクトを現在の StringReference オブジェクトに割り当てます。

構文

StringReference& operator=(const StringReference& __fstrArg);
StringReference& operator=(const ::default::char16* __strArg);

パラメーター

__fstrArg
現在の StringReference オブジェクトを初期化するために使用される、StringReference オブジェクトのアドレス。

__strArg
現在の StringReference オブジェクトを初期化するために使用される char16 値の配列へのポインター。

戻り値

StringReference 型のオブジェクトへの参照。

解説

StringReference は ref クラスではなく標準 C++ クラスであるため、オブジェクト ブラウザーに表示されません。

StringReference::operator() 演算子

StringReference オブジェクトを Platform::String^ オブジェクトに変換します。

構文

__declspec(no_release_return) __declspec(no_refcount)
         operator ::Platform::String^() const;

戻り値

Platform::String 型のオブジェクトへのハンドル。

StringReference::StringReference コンストラクター

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

構文

StringReference();
StringReference(const StringReference& __fstrArg);
StringReference(const ::default::char16* __strArg);
StringReference(const ::default::char16* __strArg, size_t __lenArg);

パラメーター

__fstrArg
新しいインスタンスを初期化するためにデータが使用される StringReference。

__strArg
新しいインスタンスを初期化するために使用される char16 値の配列へのポインター。

__lenArg
__strArg にある要素の数。

解説

このコンストラクターの最初のバージョンは、既定のコンストラクターです。 2 番目のバージョンは、StringReference パラメーターで指定されたオブジェクトから新しい __fstrArg インスタンス クラスを初期化します。 3 つ目と 4 つ目のオーバーロードは、char16 値の配列から新しい StringReference インスタンスを初期化します。 char16 は、16 ビットの UNICODE テキスト文字を表します。

関連項目

Platform::StringReference クラス