System.ReallocMemory

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ReallocMemory(P: Pointer; Size: NativeInt): Pointer; cdecl;

C++

extern DELPHI_PACKAGE void * __cdecl ReallocMemory(void * P, NativeInt Size);

Eigenschaften

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

Beschreibung

ReallocMemory ändert die Größe eines Speicherblocks.

GetMem weist einen Block mit der angegebenen Größe Size im Heap zu. Wenn Sie die Größe dieses Speicherblocks ändern müssen, rufen Sie ReallocMemory auf und übergeben in P den vorhandenen Speicherblockzeiger und in Size die neue Blockgröße. Es wird ein Zeiger auf den neuen Speicherblock zurückgegeben. Wenn ReallocMemory die Größe des Speicherblocks, auf den P zeigt, nicht erweitern kann, wird der referenzierte Speicher freigegeben, und die Werte in den neu zugewiesenen Speicher kopiert. ReallocMemory gibt dann diesen neuen Speicher zurück.

Ist nicht genug Speicher verfügbar, um den Block auf die gewünschte Größe zu erweitern, wird eine EOutOfMemory-Exception ausgelöst.

Anmerkung:  ReallocMemory ist die mit C++ kompatible Version von ReallocMem.

Siehe auch

Codebeispiele