System.AnsiStrings.AnsiStrAlloc

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function AnsiStrAlloc(Size: Cardinal): PAnsiChar;

C++

extern DELPHI_PACKAGE char * __fastcall AnsiStrAlloc(unsigned Size);

Eigenschaften

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

Beschreibung

Weist Speicher für einen nullterminierten AnsiString zu und gibt einen Zeiger auf die Adresse des ersten Zeichens zurück.

AnsiStrAlloc weist Speicher für einen nullterminierten AnsiString mit der maximalen Länge Size - 1 zu (1 Byte ist für das abschließende Nullbyte reserviert). Der zurückgegebene Wert zeigt auf die Speicherposition, an der sich das erste Zeichen befindet. Eine 32-Bit-Zahl, die den gesamten zugewiesenen Speicher angibt, wird in den vier Byte vor dem ersten Zeichen gespeichert; entspricht Size + 4. Wird mit AnsiString der Speicher für einen String reserviert, sollte er mit StrDispose wieder freigegeben werden.

AnsiStrAlloc ist veraltet, da AnsiStrings implizit nullterminiert sind und dynamisch zugewiesen werden.

Siehe auch