System.SysUtils.StrNew

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function StrNew(const Str: PAnsiChar): PAnsiChar;
function StrNew(const Str: PWideChar): PWideChar;

C++

extern DELPHI_PACKAGE char * __fastcall StrNew _DEPRECATED_ATTRIBUTE1("Moved to the AnsiStrings unit") (const char * Str)/* overload */;

Eigenschaften

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

Beschreibung

Warnung: Die ANSI-Version von StrNew ist veraltet. Bitte verwenden Sie die AnsiStrings-Unit.

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