Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::pmr::memory_resource — polimorficzny zasób pamięci

std::pmr::memory_resource to abstrakcyjny interfejs przydzielania i zwalniania pamięci z określonym wyrównaniem. Pozwala wybierać strategię alokacji w czasie działania, a std::pmr::polymorphic_allocator łączy ten interfejs z kodem oczekującym alokatora.

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

Składnia

#include <memory_resource>
std::pmr::memory_resource* resource = std::pmr::new_delete_resource();
void* p = resource->allocate(bytes, alignment);
resource->deallocate(p, bytes, alignment);

std::pmr::memory_resource, zadeklarowany w <memory_resource>, opisuje zasób pamięci, a nie typowany alokator ani kontener. Nie można tworzyć jego instancji bezpośrednio. std::pmr::polymorphic_allocator<T> korzysta z zasobu wybranego w czasie działania bez zmiany swojego typu statycznego; przechowuje wskaźnik do zasobu, nie przejmując jego własności. Zasób musi pozostać dostępny podczas korzystających z niego operacji.

allocate(bytes, alignment) przydziela co najmniej bytes bajtów o żądanym wyrównaniu; alignment musi być potęgą dwóch, a domyślnie wynosi alignof(std::max_align_t). Nie jest to ogólna operacja wywołująca konstruktory obiektów użytkownika. Niepowodzenie alokacji jest zgłaszane wyjątkiem. deallocate(p, bytes, alignment) wymaga tych samych rozmiaru i wyrównania oraz niezwróconego wcześniej bloku przydzielonego przez równy zasób. Nie wywołuje destruktorów obiektów i nie może zgłaszać wyjątków.

Publiczne funkcje przekazują pracę do prywatnych czysto wirtualnych funkcji do_allocate, do_deallocate i do_is_equal, które implementuje klasa pochodna. Destruktor interfejsu jest wirtualny. is_equal(other) oznacza, że oba zasoby mogą wzajemnie zwalniać swoje alokacje, a nie że mają identyczną konfigurację. operator== sprawdza &a == &b || a.is_equal(b).

Przykład używa new_delete_resource(), czyli zasobu o statycznym czasie życia korzystającego z ::operator new i ::operator delete. Przydziela i zwalnia blok bez zapisywania do niego, a następnie wypisuje true, ponieważ kolejne wywołania tej funkcji zwracają ten sam zasób. Kontekst wpisu to C++23; podany projekt standardu jest dokumentem aktualizowanym, a nie zamrożonym wydaniem C++23. Flaga kompilatora repozytorium nie potwierdza zgodności środowiska produkcyjnego.

Przykłady

#include <iostream>
#include <memory_resource>

int main() {
    std::pmr::memory_resource* resource =
        std::pmr::new_delete_resource();

    void* p = resource->allocate(sizeof(int), alignof(int));
    const bool equal = resource->is_equal(*std::pmr::new_delete_resource());
    resource->deallocate(p, sizeof(int), alignof(int));

    std::cout << std::boolalpha << equal << '\n';
}

Wynik

true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła