KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

aligned_alloc — geheugen toewijzen met een opgegeven uitlijning

aligned_alloc wijst niet-geïnitialiseerd geheugen toe met de gevraagde uitlijning. Controleer of het resultaat NULL is en geef het geheugen vrij met free.

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

Syntax

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

aligned_alloc uit <stdlib.h> wijst size bytes toe met uitlijning alignment. De inhoud is onbepaald: schrijf waarden voordat je ze leest.

Bij een niet-ondersteunde of ongeldige uitlijning wordt een nullpointer teruggegeven. De toewijzing kan ook mislukken als er onvoldoende geheugen beschikbaar is. Ga er niet van uit dat elke macht van twee wordt ondersteund.

N3096, §7.24.3.1, vereist niet dat size een veelvoud is van alignment. Pas beperkingen uit oudere versies niet automatisch toe op deze C23-tekst.

Het voorbeeld gebruikt alignof(int) en geeft het geheugen vrij met free. Gebruik de pointer niet nadat het geheugen is vrijgegeven. Een C23-compileroptie bevestigt niet dat de runtimebibliotheek aan de eisen voldoet.

Voorbeelden

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

Resultaat

10

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen