WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

aligned_alloc — Speicher mit festgelegter Ausrichtung reservieren

aligned_alloc reserviert nicht initialisierten Speicher mit der angeforderten Ausrichtung. Prüfen Sie, ob das Ergebnis NULL ist, und geben Sie den Speicher mit free frei.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <stdlib.h>
void *aligned_alloc(size_t alignment, size_t size);

aligned_alloc aus <stdlib.h> reserviert size Byte mit der Ausrichtung alignment. Der Inhalt ist unbestimmt: Schreiben Sie Werte hinein, bevor Sie sie lesen.

Bei einer nicht unterstützten oder ungültigen Ausrichtung wird ein Nullzeiger zurückgegeben. Die Reservierung kann auch scheitern, wenn nicht genügend Speicher verfügbar ist. Gehen Sie nicht davon aus, dass jede Zweierpotenz unterstützt wird.

N3096, §7.24.3.1, verlangt nicht, dass size ein Vielfaches von alignment ist. Übertragen Sie Einschränkungen älterer Versionen nicht automatisch auf diesen C23-Text.

Das Beispiel verwendet alignof(int) und gibt den Speicher mit free frei. Verwenden Sie den Zeiger nach dem Freigeben nicht weiter. Eine C23-Compileroption bestätigt nicht die Konformität der Laufzeitbibliothek.

Beispiele

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    int *p = aligned_alloc(alignof(int), 4 * sizeof *p);
    if (p == NULL) {
        puts("allocation failed");
        return EXIT_FAILURE;
    }

    for (int i = 0; i < 4; ++i) {
        p[i] = i + 1;
    }
    printf("%d\n", p[0] + p[1] + p[2] + p[3]);
    free(p);
    return EXIT_SUCCESS;
}

Ergebnis

10

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen