Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

aligned_alloc — alocar memória com um alinhamento especificado

aligned_alloc aloca memória não inicializada com o alinhamento pedido. Verifique se o resultado é NULL e liberte a memória com free.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

aligned_alloc de <stdlib.h> aloca size bytes com o alinhamento alignment. O conteúdo é indeterminado: escreva valores antes de os ler.

Um alinhamento não suportado ou inválido faz com que seja devolvido um ponteiro nulo. A alocação também pode falhar por falta de memória disponível. Não presuma que todas as potências de dois são suportadas.

N3096, §7.24.3.1, não exige que size seja um múltiplo de alignment. Não aplique automaticamente as restrições de versões anteriores a este texto de C23.

O exemplo usa alignof(int) e liberta a memória com free. Não utilize o ponteiro depois de libertar a memória. Uma opção do compilador C23 não comprova a conformidade da biblioteca de execução.

Exemplos

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

Resultado

10

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes