System.WideStrUtils.WStrNew

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function WStrNew(const Str: PWideChar): PWideChar;

C++

extern DELPHI_PACKAGE System::WideChar * __fastcall WStrNew(const System::WideChar * Str);

Eigenschaften

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

Beschreibung

Weist Speicher zu, kopiert ein PWideChar in den Heap und gibt ein neues PWideChar zurück.

WStrNew legt eine Kopie von Str auf dem Heap an.

Wenn Str den Wert nil (Delphi) bzw. NULL (C++) hat oder auf einen leeren String zeigt, gibt WStrNew einen Zeiger auf ein neues leeres PWideChar zurück.

Ansonsten erzeugt WStrNew eine genaue Kopie von Str, reserviert mit einem Aufruf von WStrAlloc den entsprechenden Speicher und gibt einen Zeiger auf die Kopie zurück.

Der zugewiesene Speicher entspricht der Länge von Str * 2 + 5 Byte.

Siehe auch