System.UniqueString
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 または AnsiString の c_str() メソッド、t_str() メソッド、または data() メソッドを使用する。または WideString の c_bstr() メソッドを使用する(c_str() よりも data() の使用をお勧めします。なぜなら、c_str() は、NULL の UnicodeString または AnsiString に対して空文字列を返すからです)。