CKTIS / C++
std::pmr::memory_resource — risorsa di memoria polimorfica
std::pmr::memory_resource è un’interfaccia astratta per allocare e deallocare memoria con un allineamento specificato. Consente di scegliere una strategia di allocazione a runtime, mentre std::pmr::polymorphic_allocator collega questa interfaccia al codice che si aspetta un allocatore.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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, dichiarato in <memory_resource>, rappresenta una risorsa di memoria, non un allocatore tipizzato né un contenitore. Non può essere istanziato direttamente. std::pmr::polymorphic_allocator<T> usa una risorsa scelta a runtime senza modificare il proprio tipo statico; memorizza un puntatore alla risorsa senza assumerne la proprietà. La risorsa deve restare disponibile durante le operazioni che la usano.
allocate(bytes, alignment) alloca almeno bytes byte con l’allineamento richiesto; alignment deve essere una potenza di due e, per impostazione predefinita, è alignof(std::max_align_t). Non è un’operazione generica per invocare i costruttori di oggetti definiti dall’utente. Un errore di allocazione viene segnalato tramite un’eccezione. deallocate(p, bytes, alignment) richiede la stessa dimensione e lo stesso allineamento, oltre a un blocco non già deallocato e allocato tramite una risorsa equivalente. Non invoca i distruttori degli oggetti e non deve generare eccezioni.
Le funzioni pubbliche delegano alle funzioni virtuali pure private do_allocate, do_deallocate e do_is_equal, implementate da una classe derivata. L’interfaccia ha un distruttore virtuale. is_equal(other) significa che entrambe le risorse possono deallocare le allocazioni dell’altra, non che abbiano configurazioni identiche. operator== verifica &a == &b || a.is_equal(b).
L’esempio usa new_delete_resource(), una risorsa con durata statica basata su ::operator new e ::operator delete. Alloca e dealloca un blocco senza scrivervi, quindi stampa true perché chiamate ripetute a questa funzione restituiscono la stessa risorsa. Questa voce si riferisce a C++23; la bozza di lavoro fornita è un documento in evoluzione, non un’edizione C++23 definitiva. L’opzione del compilatore del repository non dimostra la compatibilità dell’ambiente di runtime di produzione.
Esempi
#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';
}
Risultato
true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.