System.ReallocMemory

提供: RAD Studio API Documentation
移動先: 案内検索

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++ 互換バージョンです。

関連項目