System.UniqueString

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

procedure UniqueString(var str: UnicodeString); overload;
procedure UniqueString(var str: _WideStr);
procedure UniqueString(var str: _AnsiStr);

C++

extern DELPHI_PACKAGE void __fastcall UniqueString(UnicodeString &Str)/* overload */;

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
System.pas
System.hpp
System System

説明

与えられた文字列が参照カウント 1 を持つことを保証します。

UniqueString は、文字列の参照カウントを強制的に 1 にします。必要であれば、その文字列をメモリ上でコピーします。通常の文字列処理では、UniqueString を呼び出す必要はありません。UniqueString は、アプリケーションが、以下の処理の後で文字列の内容を変更する場合にのみ使用します。

  • Delphi で、文字列を PAnsiChar または PWideChar にキャストする。
  • C++ で、UnicodeString または AnsiStringc_str() メソッド、t_str() メソッド、または data() メソッドを使用する。または WideStringc_bstr() メソッドを使用する(c_str() よりも data() の使用をお勧めします。なぜなら、c_str() は、NULL の UnicodeString または AnsiString に対して空文字列を返すからです)。

関連項目