realloc()

Выделить, перевыделить или освободить область памяти

Прототип:

#include <stdlib.h>
                                       
void * realloc( void *old_blk, 
                size_t size );

Аргументы:

old_blk

Указатель на блок памяти, который нужно выделить, перевыделить или освободить.

size

Новый размер блока памяти в байтах.

Библиотека:

libc

Описание:

Функция realloc() выделяет, перевыделяет или освобождает область памяти, указанную в old_blk, основываясь на правилах, описанных далее. Вы можете частично контролировать поведение функции с помощью переменной окружения MALLOC OPTIONS.

• Если old_blk равен NULL и size не равен 0, realloc() выделяет новую область памяти размером size байт.

• Если old_blk равен NULL и size равен 0, поведение по умолчанию - вернуть указатель, отличный от NULL, который действителен только для соответствующего вызова free() или realloc(). Не стоит предполагать, что этот указатель указывает на любую допустимую память. Если значение MALLOC_OPTIONS содержит V, realloc() возвращает указатель NULL. Эта переменная окружения также влияет на calloc() и malloc(). Это известно как поведение «System V».

• Если old_blk не равен NULL и size равен 0, по умолчанию возвращается действительный указатель, отличный от NULL, который действителен только для соответствующего вызова free() или realloc(). Не стоит предполагать, что этот указатель указывает на любую допустимую память. Если значение MALLOC_OPTIONS содержит R илиV, realloc() вызывает free() для освобождения памяти, на которую указывает old_blk, а затем возвращает NULL.

• В противном случае realloc() перевыделяет память для объекта размером size байт следующим образом:
  • уменьшение размера выделенного блока памяти old_blk, когда size меньше текущего размера old_blk

  • увеличение выделенного размера выделенного блока памяти old_blk, если сразу после old_blk есть достаточно большой блок нераспределенной памяти

  • выделение нового блока с соответствующим size и копирование содержимого old_blk в этот новый блок

Функция realloc() выделяет память из кучи. Используйте free() или realloc(), чтобы освободить блок памяти.

---

Реализация malloc() использует 32-битные целые числа со знаком для внутреннего представления размера, поэтому невозможно выделить более 2 ГБ за один вызов функции. Если размер выделяемой памяти превышает 2 ГБ, realloc() указывает на ошибку ENOMEM. Поскольку возможно, что будет выделен новый блок, любые указатели на старую память могут стать недействительными. Эти указатели будут указывать на освобожденную память и любые действия с ними могут иметь неблагоприятные последствия после выделении нового блока памяти.

---

Функция realloc() возвращает NULL, если память, на которую указывает old_blk, не может быть перевыделена. В этом случае память, на которую указывает old_blk, не освобождается, поэтому желательно сохранить указатель на старый блок памяти, чтобы можно было освободить его позже.

В следующем примере для buffer устанавливается значение NULL, если функция завершается с ошибкой, и buffer не будет указывать на старый блок памяти. Если buffer - единственный указатель на блок памяти, то вы потеряете доступ к этой памяти.

buffer = (char *)realloc( buffer, 100 );

Возвращаемое значение:

Указатель на начало выделенной памяти.

Если возникла ошибка функция возвращает NULL, код ошибки записывается в errno.

Коды ошибок:

ENOMEM

Недостаточно памяти.

EOK

Успешное завершение.

Примеры:

#include <stdlib.h>
#include <malloc.h>
                                       
int main( void )
{
    char    *buffer;
    char    *new_buffer;
                                       
    buffer = (char *)malloc( 80 );
    if ( buffer == NULL )
    {
        return (EXIT_FAILURE);
    }
                                       
    new_buffer = (char *)realloc( buffer, 100 );
    if ( new_buffer == NULL )
    {
        /* Couldn't allocate a larger buffer. Remember that buffer stills 
         * point to allocated memory -- don't leak it! */
        free( buffer );
        return (EXIT_FAILURE);
    } else {
      buffer = new_buffer;
    }
                                       
    return (EXIT_SUCCESS);
}

Переменные окружения:

MALLOC_OPTIONS

Описание см. на странице malloc().

Классификация:

ANSI, POSIX 1003.1

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Тематические ссылки:

calloc(), free(), malloc(), sbrk()

Предыдущий раздел: Описание API системной библиотеки