最小のコピー操作で 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 テキスト文字を表します。