Linux API. Исчерпывающее руководство

Аргумент ptr является указателем на блок памяти, чей размер изменяется. Аргумент size определяет желаемый новый размер блока.

В случае успеха функция realloc() возвращает указатель на местонахождение блока, размер которого был изменен. Оно может отличаться от его местонахождения до вызова этой функции. При ошибке функция realloc() возвращает NULL и оставляет блок, на который указывает аргумент ptr, нетронутым (это требование прописано в SUSv3).

Когда функция realloc() увеличивает размер блока выделенной памяти, дополнительно выделенные байты не инициализируются.

Память, выделенная с использованием функции calloc() или realloc(), должна быть высвобождена с помощью функции free().

Вызов realloc(ptr, 0) эквивалентен вызову free(ptr), за которым следует вызов malloc(0). Если для аргумента ptr указано значение NULL, то вызов функции realloc() становится эквивалентом вызова malloc(size).

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

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

nptr = realloc(ptr, newsize);

if (nptr == NULL) {

/* Обработка ошибки */

} else { /* Выполнение realloc() завершилось успешно */

ptr = nptr;

}

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

Поскольку realloc() может переместить блок памяти, любые указатели, ссылающиеся на места внутри блока перед вызовом функции realloc(), могут утратить свою актуальность после вызова. Гарантированно будет актуальным только смещение относительно начала блока, остальные способы указать элемент не работают.

Выделение выровненной памяти: memalign() и posix_memalign()

Функции memalign() и posix_memalign() предназначены для выделения памяти, начиная с адреса, который будет кратен некоторой степени двойки, что может весьма пригодиться для отдельных приложений (см., к примеру, листинг 13.1).

#include

void *memalign(size_t boundary, size_t size);

Возвращает указатель на выделенную память при успешном завершении или NULL при ошибке

Функция memalign() выделяет size байтов, начиная с адреса, выровненного по границе, кратной степени числа два. В результате выполнения функция возвращает адрес выделенной памяти.

Функция memalign() присутствует не во всех реализациях UNIX. Большинство других реализаций UNIX, предоставляющих memalign(), для получения объявления функции требуют включения вместо заголовочного файла .

В SUSv3 функция memalign() не указана, но вместо нее есть точно такая же функция под названием posix_memalign(). Эта функция была недавно создана комитетом по стандартизации и появилась лишь в нескольких реализациях UNIX.

#include

int posix_memalign(void **memptr, size_t alignment, size_t size);

Возвращает 0 при успешном завершении или номер ошибки в виде положительного числа при ошибке

Функция posix_memalign() отличается от memalign() двумя деталями:

• адрес выделенной памяти возвращается в memptr;

• память выравнивается по значению степени числа два, которое кратно значению sizeof(void *) (4 или 8 байт в большинстве аппаратных архитектур).

Обратите внимание также на необычное возвращаемое этой функцией значение. Вместо того чтобы при ошибке возвратить –1, она возвращает номер ошибки (то есть положительное целое число того типа, который обычно возвращается в errno).

Если значение sizeof(void *) равно 4, то так с помощью функции posix_memalign() можно выделить 65 536 байт памяти, выровненных по 4096-байтовой границе:

int s;

void *memptr;

s = posix_memalign(&memptr, 1024 * sizeof(void *), 65536);

if (s!= 0)

/* Обработка ошибки */

Блоки памяти, выделенные с использованием memalign() или posix_memalign(), должны высвобождаться с помощью функции free().