Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

aligned_alloc — allocare memoria con un allineamento specificato

aligned_alloc alloca memoria non inizializzata con l’allineamento richiesto. Controlla che il risultato non sia NULL e libera la memoria con free.

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

Sintassi

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

aligned_alloc di <stdlib.h> alloca size byte con l’allineamento alignment. Il contenuto è indeterminato: scrivi dei valori prima di leggerli.

Un allineamento non supportato o non valido fa restituire un puntatore nullo. L’allocazione può fallire anche se la memoria disponibile non è sufficiente. Non dare per scontato che sia supportata qualsiasi potenza di due.

N3096, §7.24.3.1, non richiede che size sia un multiplo di alignment. Non trasferire automaticamente a questo testo C23 le restrizioni delle versioni precedenti.

L’esempio usa alignof(int) e libera la memoria con free. Non usare il puntatore dopo aver liberato la memoria. Un’opzione del compilatore C23 non attesta la conformità della libreria di runtime.

Esempi

#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;
}

Risultato

10

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti