realloc

[アーティクル]
08/09/2011

メモリブロックの再割り当てを行います。

void *realloc(
   void *memblock,
   size_t size 
);

パラメーター

memblock
事前に割り当てられているメモリブロックへのポインター。
size
新しいサイズ (バイト単位)。

戻り値

realloc は、再割り当て (および移動) されたメモリブロックへの void ポインターを返します。

指定のサイズまでブロックを拡張するだけのメモリ領域がない場合、元のブロックは変更されず、NULL が返されます。

size がゼロの場合、memblock が指すブロックは解放され、NULL が返され、memblock は解放されたブロックを指したままになります。

戻り値が指すメモリ領域は、どの型のオブジェクトを格納する場合でも、適切にアライメントされます。 void 以外の型へのポインターを得るには、戻り値に型キャストを行います。

解説

realloc 関数は、既に割り当てられているメモリブロックのサイズを変更します。引数 memblock は、メモリブロックの先頭を指します。 memblock が NULL の場合、realloc 関数は malloc 関数と同様に動作し、size バイトの新しいブロックを割り当てます。 memblock を NULL 以外にする場合は、以前に呼び出した calloc、malloc、または realloc のいずれかの関数によって返されたポインターを渡します。

引数 size には、変更後の新しいブロックのサイズをバイト単位で指定します。ブロックの内容は、新しいサイズと古いサイズのうち小さい方のサイズまでは同じですが、新しいブロックは別の位置に割り当てられる場合があります。再割り当てされた新しいブロックは、メモリ内の別の位置に割り当てられることがあるため、realloc 関数の戻り値が、引数 memblock で渡したポインターと異なる場合があります。 realloc は、バッファーが拡張された場合、新たに割り当てられたメモリをゼロで初期化することはしません。

realloc設定errnoにENOMEMメモリ割り当てに失敗した場合、またはメモリの量を超える要求する場合_HEAP_MAXREQ。このエラーコードおよびその他のエラーコードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。

realloc は malloc を呼び出し、C++ の _set_new_mode 関数を使用し、new ハンドラーモードを設定します。メモリの割り当てに失敗した場合、new ハンドラーのモードに応じて、malloc 関数が _set_new_handler で設定されている new ハンドラールーチンを呼び出すかどうかが決まります。既定では、malloc 関数はメモリの割り当てに失敗しても new ハンドラールーチンを呼び出しません。既定の動作をオーバーライドすると、new 演算子がメモリの割り当てに失敗したときと同じように、realloc 関数がメモリの割り当てに失敗した場合にも、malloc 関数は new ハンドラーのルーチンを呼び出すことができます。既定の動作をオーバーライドするには、プログラムの始めの方で次の関数を呼び出すか、または NEWMODE.OBJ とリンクします。

_set_new_mode(1)

「リンクオプション」を参照してください。

アプリケーションを C ランタイムライブラリのデバッグバージョンとリンクすると、realloc 関数は _realloc_dbg へと解決されます。デバッグ中のヒープの処理方法の詳細については、「CRT デバッグヒープ」を参照してください。

realloc には __declspec(noalias) と __declspec(restrict) のマークが付けられます。これは、関数がグローバル変数を変更しないことを保証し、返されるポインターがエイリアス指定されないことを意味します。詳細については、「noalias」および「restrict」を参照してください。

必要条件

ルーチン	必須ヘッダー
realloc	<stdlib.h> および <malloc.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

// crt_realloc.c
// This program allocates a block of memory for
// buffer and then uses _msize to display the size of that
// block. Next, it uses realloc to expand the amount of
// memory used by buffer and then calls _msize again to
// display the new amount of memory allocated to buffer.
 

#include <stdio.h>
#include <malloc.h>
#include <stdlib.h>

int main( void )
{
   long *buffer, *oldbuffer;
   size_t size;

   if( (buffer = (long *)malloc( 1000 * sizeof( long ) )) == NULL )
      exit( 1 );

   size = _msize( buffer );
   printf_s( "Size of block after malloc of 1000 longs: %u\n", size );

   // Reallocate and show new size:
   oldbuffer = buffer;     // save pointer in case realloc fails
   if( (buffer = realloc( buffer, size + (1000 * sizeof( long )) )) 
        ==  NULL )
   {
      free( oldbuffer );  // free original block
      exit( 1 );
   }
   size = _msize( buffer );
   printf_s( "Size of block after realloc of 1000 more longs: %u\n", 
            size );

   free( buffer );
   exit( 0 );
}