System.AnsiStrings.StrNew

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function StrNew(const Str: PAnsiChar): PAnsiChar;

C++

extern DELPHI_PACKAGE char * __fastcall StrNew(const char * Str)/* overload */;

Eigenschaften

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

Beschreibung

Reserviert Speicher, kopiert einen String auf den Heap und gibt einen Zeiger auf den String zurück.

StrNew 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 StrNew einen Zeiger auf einen neuen leeren String zurück.

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

Der zugewiesene Speicher entspricht der Länge von Str + 5 Bytes.

Siehe auch

Codebeispiele