System.ReallocMemory
Delphi
function ReallocMemory(P: Pointer; Size: NativeInt): Pointer; cdecl;
C++
extern DELPHI_PACKAGE void * __cdecl ReallocMemory(void * P, NativeInt Size);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.pas System.hpp |
System | System |
説明
ReallocMemory は、メモリ ブロックのサイズを変更します。
GetMem は、与えられたサイズ Size のメモリ ブロックをヒープ上に割り当てます。このメモリ ブロックのサイズを変更する必要がある場合は、ReallocMemory を呼び出します。その際、既存のメモリ ブロックのポインタを P、新しいブロック サイズを Size として渡します。サイズ変更されたメモリ ブロックへのポインタが返ります。ReallocMemory は、P で参照されるメモリ ブロックを拡張できない場合、参照先のメモリを解放し、新たに割り当てたメモリにその値をコピーします。そして、新たに割り当てたメモリを返します。
メモリ ブロックを希望のサイズまで拡張するために十分なメモリがない場合は、EOutOfMemory 例外が発生します。
メモ: ReallocMemory は、ReallocMem の C++ 互換バージョンです。