Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

aligned_alloc — allouer de la mémoire avec un alignement spécifié

aligned_alloc alloue de la mémoire non initialisée avec l’alignement demandé. Vérifiez que le résultat n’est pas NULL et libérez la mémoire avec free.

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

Syntaxe

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

aligned_alloc, déclarée dans <stdlib.h>, alloue size octets avec l’alignement alignment. Le contenu est indéterminé : écrivez des valeurs avant de les lire.

Un alignement non pris en charge ou invalide entraîne le retour d’un pointeur nul. L’allocation peut aussi échouer faute de mémoire disponible. Ne supposez pas que toute puissance de deux est prise en charge.

N3096, §7.24.3.1, n’exige pas que size soit un multiple de alignment. Ne transposez pas automatiquement les restrictions des versions antérieures à ce texte C23.

L’exemple utilise alignof(int) et libère la mémoire avec free. N’utilisez pas le pointeur après la libération. Une option du compilateur C23 ne garantit pas la conformité de la bibliothèque d’exécution.

Exemples

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

Résultat

10

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources