realloc

指定されたメモリ領域を再割り当てします。 ptr がNULLでない場合、それは以前に malloc 、 calloc または realloc によって割り当てられており、かつ free または realloc の呼び出しによってまだ解放されていないものでなければなりません。そうでない場合、結果は未定義です。

再割り当ては以下のいずれかの方法で行われます：

十分なメモリがない場合、古いメモリブロックは解放されず、ヌルポインタが返されます。

ptr が NULL の場合、動作は malloc ( new_size ) を呼び出す場合と同じです。

それ以外の場合、

パラメータ

戻り値

成功時は、新たに割り当てられたメモリの先頭へのポインタを返します。メモリリークを避けるため、返されたポインタは free または realloc で解放されなければなりません。元のポインタ ptr は無効化され、それへのアクセスは未定義動作となります（たとえ再割り当てがインプレースで行われた場合でも）。

失敗時にはヌルポインタを返します。元のポインタ ptr は有効なまま残り、 free または realloc による解放が必要な場合があります。

注記

元々（C89では）、以下のようなコードに対応するためにゼロサイズのサポートが追加されました

OBJ *p = calloc(0, sizeof(OBJ)); // 「ゼロ長」プレースホルダー
/*...*/
while (1)
{
    p = realloc(p, c * sizeof(OBJ)); // サイズが確定するまで再割り当て
    /* cを変更するかループを抜ける可能性のあるコード */
}

例

#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
void print_storage_info(const int* next, const int* prev, int ints)
{
    if (next)
        printf("%s location: %p. Size: %d ints (%ld bytes).\n",
               (next != prev ? "New" : "Old"), (void*)next, ints, ints * sizeof(int));
    else
        printf("Allocation failed.\n");
}
int main(void)
{
    const int pattern[] = {1, 2, 3, 4, 5, 6, 7, 8};
    const int pattern_size = sizeof pattern / sizeof(int);
    int *next = NULL, *prev = NULL;
    if ((next = (int*)malloc(pattern_size * sizeof *next))) // allocates an array
    {
        memcpy(next, pattern, sizeof pattern); // fills the array
        print_storage_info(next, prev, pattern_size);
    }
    else
        return EXIT_FAILURE;
    // Reallocate in cycle using the following values as a new storage size.
    const int realloc_size[] = {10, 12, 512, 32768, 65536, 32768};
    for (int i = 0; i != sizeof realloc_size / sizeof(int); ++i)
    {
        if ((next = (int*)realloc(prev = next, realloc_size[i] * sizeof(int))))
        {
            print_storage_info(next, prev, realloc_size[i]);
            assert(!memcmp(next, pattern, sizeof pattern));  // is pattern held
        }
        else // if realloc failed, the original pointer needs to be freed
        {
            free(prev);
            return EXIT_FAILURE;
        }
    }
    free(next); // finally, frees the storage
    return EXIT_SUCCESS;
}

New location: 0x144c010. Size: 8 ints (32 bytes).
Old location: 0x144c010. Size: 10 ints (40 bytes).
New location: 0x144c450. Size: 12 ints (48 bytes).
Old location: 0x144c450. Size: 512 ints (2048 bytes).
Old location: 0x144c450. Size: 32768 ints (131072 bytes).
New location: 0x7f490c5bd010. Size: 65536 ints (262144 bytes).
Old location: 0x7f490c5bd010. Size: 32768 ints (131072 bytes).

参考文献

関連項目