System.UniqueString

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.pas
System.hpp
System System

Beschreibung

Stellt sicher, dass ein gegebener String den Referenzzähler Eins hat.

UniqueString erzwingt bei einem String einen Referenzzähler von Eins und kopiert bei Bedarf den String in den Arbeitsspeicher. Bei der regulären Stringbehandlung muss UniqueString nicht aufgerufen werden. UniqueString wird nur verwendet, wenn eine Anwendung den Inhalt eines Strings nach den folgenden Operationen ändert:

  • Typumwandlung des String in PAnsiChar oder PWideChar in Delphi.
  • Verwendung der Methoden c_str(), t_str() oder data() von UnicodeString oder AnsiString oder der Methode c_bstr() von WideString in C++. (Verwenden Sie statt c_str() lieber data(), weil c_str() einen leeren String für einen NULL-UnicodeString oder -AnsiString zurückgibt.)

Siehe auch

Codebeispiele