Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::align_val_t — tip argumenta poravnanja memorije

std::align_val_t iz zaglavlja <new> prenosi potrebno poravnanje preopterećenjima za alokaciju i dealokaciju. To je zaseban enumeracijski tip koji omogućuje razlikovanje argumenta poravnanja od argumenta veličine memorije.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <new>
// Declaration in namespace std:
enum class align_val_t : size_t {};

// Explicit aligned allocation and matching deallocation:
void* p = ::operator new(sizeof(T), std::align_val_t{alignof(T)});
::operator delete(p, std::align_val_t{alignof(T)});

std::align_val_t je enumeracija s opsegom, deklarirana u <new>, bez imenovanih enumeratora i s osnovnim tipom std::size_t. Vrijednost poput std::align_val_t{alignof(T)} navodi potrebno poravnanje u bajtovima, a ne veličinu alokacije. Zaseban tip razlikuje preopterećenja koja prihvaćaju poravnanje od onih koja prihvaćaju veličinu.

Za new T, kada poravnanje tipa premašuje __STDCPP_DEFAULT_NEW_ALIGNMENT__, odabir alokacijske funkcije najprije razmatra argument poravnanja tipa std::align_val_t. Vlastita preopterećenja za klasu mogu utjecati na odabir; uobičajeni kod ne mora ručno prosljeđivati taj argument.

Izravan poziv ::operator new(size, alignment) alocira memoriju, ali ne poziva konstruktor za T. Oslobodite tu memoriju odgovarajućim pozivom ::operator delete(ptr, alignment) i proslijedite istu vrijednost poravnanja. Nemojte miješati te funkcije s free, običnom dealokacijom bez poravnanja ni oblicima za polja. U C++23 oslobađanje dinamički alocirane memorije može završiti životni vijek objekta bez poziva njegova destruktora, čak i ako je destruktor netrivijalan. Oslobađanje memorije ne poziva destruktor implicitno, pa se njegove radnje čišćenja ne izvršavaju niti nastaju njegovi ostali popratni učinci.

Pretvorba u std::align_val_t ne provjerava poravnanje: prosljeđivanje nevaljane vrijednosti alokacijskim ili dealokacijskim funkcijama uzrokuje nedefinirano ponašanje. Koristite alignof(T) umjesto nagađanja o podržanim vrijednostima. U primjeru placement new inicijalizira int, rezultat se kopira, a memorija se oslobađa prije ispisa. Za int nije potreban izričit poziv destruktora.

Primjeri

#include <iostream>
#include <new>

int main() {
    constexpr auto alignment = std::align_val_t{alignof(int)};
    void* storage = ::operator new(sizeof(int), alignment);
    int* value = ::new (storage) int{42};
    const int result = *value;
    ::operator delete(storage, alignment);
    std::cout << result << '\n';
}

Rezultat

42

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori