Freigeben über


_aligned_recalloc

Ändert die Größe eines Speicherblocks, der zugewiesen _aligned_malloc wurde, oder _aligned_offset_malloc initialisiert den Speicher auf 0.

Syntax

void * _aligned_recalloc(
   void *memblock,
   size_t num,
   size_t size,
   size_t alignment
);

Parameter

memblock
Der Zeiger auf den aktuellen Speicherblock.

number
Die Anzahl der Elemente.

size
Die Größe jedes Elements in Byte.

alignment
Der Ausrichtungswert, der eine ganzzahlige Potenz von 2 sein muss.

Rückgabewert

_aligned_recalloc gibt einen leeren Zeiger auf den neu belegten (und möglicherweise verschobenen) Speicherblock zurück. Der Rückgabewert ist NULL , wenn die Größe null ist und das Pufferargument nicht NULLvorhanden ist, oder wenn nicht genügend Arbeitsspeicher verfügbar ist, um den Block auf die angegebene Größe zu erweitern. Im ersten Fall wird der ursprüngliche Block freigegeben. Im zweiten Fall wird der ursprüngliche Block nicht geändert. Der Rückgabewert verweist auf einen Speicherplatz, der für die Speicherung eines beliebigen Objekttyps entsprechend ausgerichtet ist. Um einen Zeiger auf einen anderen Typ als den leeren zurückzugeben, verwenden Sie eine Typumwandlung für den Rückgabewert.

Es ist ein Fehler, Speicher neu zu ordnen und die Ausrichtung eines Blocks zu ändern.

Hinweise

_aligned_recalloc ist auf malloc basiert. Weitere Informationen zur Verwendung von _aligned_offset_malloc finden Sie unter malloc.

Diese Funktion legt errno auf ENOMEM fest, wenn die Speicherbelegung fehlgeschlagen ist oder die angeforderte Größe größer als _HEAP_MAXREQ war. Weitere Informationen zu errno, sieheerrno , , _doserrno, _sys_errlistund _sys_nerr. Darüber hinaus überprüft _aligned_recalloc auch die eigenen Parameter. Wenn alignment keine Potenz von 2 ist, ruft diese Funktion den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt diese Funktion NULL zurück und stellt errno auf EINVAL ein.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Routine Erforderlicher Header
_aligned_recalloc <malloc.h>

Siehe auch

Datenausrichtung
_recalloc
_aligned_offset_recalloc