realloc

Статья
06/09/2015

Перераспределяет блоки памяти.

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, and _sys_nerr.

reallocвызывает malloc, чтобы использовать C++ функцию _set_new_mode для установки нового режима обработки. Указывает, может ли новый режим обработки, при сбое вызова malloc, использовать новую процедуру обработчика как набор _set_new_handler. По умолчанию malloc не вызывает новую процедуру обработчика при сбое выделения памяти. Можно переопределить это поведение по умолчанию, чтобы в случае сбоя предоставления памяти методом realloc метод malloc вызывал новую процедуру обработчика таким же образом, как это делает оператор new при сбое по той же причине. Чтобы переопределить значение по умолчанию, вызовите

_set_new_mode(1)

ранее в программе или выполняйте компоновку с NEWMODE.OBJ (см. Параметры ссылок).

Когда приложение связано с отладочной версией библиотек времени выполнения языка C, realloc соответствует _realloc_dbg. Дополнительные сведения о том, как происходит управление кучей в процессе отладки см. в разделе Отладочная куча CRT.

realloc помечен __declspec(noalias) и __declspec(restrict), что означает, что функция гарантированно не изменит глобальные переменные, а для возвращаемого указателя не будет создан псевдоним. Дополнительные сведения см. в разделах noalias и restrict.

Требования

Подпрограмма	Обязательный заголовок
realloc	<stdlib.h> и <malloc.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

// 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 );
}