CKTIS / C++
std::pmr::monotonic_buffer_resource — allocation avec libération groupée
std::pmr::monotonic_buffer_resource fournit de la mémoire pour des allocations successives sans tenir compte des désallocations individuelles. release() restitue les blocs à la ressource amont et réinitialise la ressource pour la réutiliser.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstddef>
#include <memory_resource>
void use_resource(void* buffer, std::size_t buffer_size,
std::pmr::memory_resource* upstream) {
{
std::pmr::monotonic_buffer_resource resource;
}
{
std::pmr::monotonic_buffer_resource resource(buffer, buffer_size);
}
{
std::pmr::monotonic_buffer_resource resource(buffer, buffer_size, upstream);
resource.release();
}
}std::pmr::monotonic_buffer_resource, déclarée dans <memory_resource>, est une ressource mémoire utile lorsque les objets sont construits progressivement et que la mémoire peut être récupérée en une seule fois. Les conteneurs PMR, comme std::pmr::vector<int>, peuvent l’utiliser via un allocateur. Les appels individuels de désallocation ne récupèrent aucun espace ; la croissance d’un conteneur peut donc laisser les blocs précédents occupés.
Vous pouvez fournir un tampon initial. Lorsque l’espace restant ne suffit pas pour la taille et l’alignement demandés, la ressource obtient un autre bloc auprès de sa ressource amont ; la taille des blocs dépend de l’implémentation. Sans argument upstream explicite, elle utilise la ressource mémoire par défaut. Le tampon initial ne constitue donc pas une limite stricte de consommation mémoire.
std::pmr::monotonic_buffer_resource::release() restitue tous les blocs obtenus à la ressource amont et rétablit l’état initial des allocations, ce qui permet de réutiliser le tampon fourni. Cette fonction ne libère pas le tampon appartenant à l’appelant et n’appelle pas les destructeurs des objets stockés. Détruisez d’abord les objets et les conteneurs utilisant ces allocations ; appeler simplement clear() sur un conteneur ne suffit pas, car il peut conserver sa capacité. Le destructeur de la ressource appelle lui aussi release(). Le tampon et la ressource amont doivent rester disponibles tant que la ressource les utilise.
L’exemple détruit le premier vecteur avant release(), puis en crée un second avec la même ressource. Portée de l’entrée : C++23 ; l’option du compilateur du dépôt ne garantit pas l’environnement d’exécution de production. Le document lié est un projet de travail évolutif, et non une publication C++23 figée.
Exemples
#include <cstddef>
#include <iostream>
#include <memory_resource>
#include <vector>
int main() {
alignas(std::max_align_t) std::byte buffer[256];
std::pmr::monotonic_buffer_resource resource(buffer, sizeof buffer);
{
std::pmr::vector<int> values(&resource);
values.reserve(3);
values.push_back(1);
values.push_back(2);
values.push_back(3);
std::cout << values[0] + values[1] + values[2] << '\n';
}
resource.release();
{
std::pmr::vector<int> values(&resource);
values.push_back(4);
std::cout << values.front() << '\n';
}
}
Résultat
6 4
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.