CKTIS / C++
std::pmr::vector: recursos de memoria y asignadores de los elementos
Elige un recurso de memoria para un vector PMR y comprueba cuándo sus elementos reciben ese mismo recurso y en qué se diferencia un vector ordinario.
Versión: ISO C++23; implementation support may vary
Sintaxis
#include <vector>
#include <string>
#include <memory_resource>
#include <cstddef>
// Equivalent types (T is the element type):
// std::pmr::vector<T> = std::vector<T, std::pmr::polymorphic_allocator<T>>
// std::pmr::string = std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>
// In a block scope:
std::byte buffer[4096];
std::pmr::monotonic_buffer_resource arena{buffer, sizeof buffer};
std::pmr::vector<std::pmr::string> data{&arena};
data.emplace_back("PMR");std::pmr::vector<T>, de <vector>, es un alias de std::vector<T, std::pmr::polymorphic_allocator<T>>, no una clase de contenedor independiente. std::pmr::string, de <string>, es std::basic_string para char con std::pmr::polymorphic_allocator<char>. Ambos alias y std::byte se introdujeron en C++17 y forman parte de C++23; la compatibilidad puede variar según la implementación.
Un asignador polimórfico dirige las solicitudes de memoria a un std::pmr::memory_resource elegido en tiempo de ejecución. Con data{&arena} eliges explícitamente arena para el almacenamiento de los elementos del vector. Un asignador polimórfico construido por defecto obtiene el recurso actual mediante std::pmr::get_default_resource(). Esto no equivale a std::allocator<T>, el tipo de asignador predeterminado de un std::vector<T> ordinario.
Al llamar a emplace_back("PMR") en un std::pmr::vector<std::pmr::string>, la construcción que tiene en cuenta el asignador pasa el recurso del vector a la nueva cadena, que lo usa si necesita almacenamiento separado para sus caracteres. Si DATA designa std::pmr::string, un std::vector<DATA> ordinario sigue usando std::allocator<DATA> para guardar sus elementos. En esta llamada no pasa ningún recurso al constructor de la cadena, por lo que esta obtiene el recurso PMR predeterminado. A la inversa, una std::string no empieza a usar PMR solo por ser un elemento de un vector PMR.
std::byte, de <cstddef>, es una enumeración de ámbito propio con tipo subyacente unsigned char. Un array de ese tipo proporciona aquí almacenamiento en bruto para un std::pmr::monotonic_buffer_resource de <memory_resource>. Si una solicitud no cabe en el espacio disponible, el recurso pide otro bloque a su recurso de respaldo. Si este es std::pmr::null_memory_resource(), la solicitud lanza std::bad_alloc.
El vector no es propietario del recurso. Declara el búfer, el recurso y el contenedor en ese orden para que el contenedor se destruya primero. No llames a release() mientras haya objetos que dependan de la memoria asignada por el recurso. Un recurso monotónico no recupera espacio con cada liberación individual.
Ejemplos
#include <cstddef>
#include <iostream>
#include <memory_resource>
#include <string>
#include <type_traits>
#include <vector>
int main() {
using DATA = std::pmr::string;
static_assert(std::is_same_v<std::vector<DATA>::allocator_type,
std::allocator<DATA>>);
std::byte buffer[4096];
std::pmr::monotonic_buffer_resource arena{buffer, sizeof buffer};
std::pmr::vector<DATA> pmr_data{&arena};
std::vector<DATA> ordinary_data;
pmr_data.emplace_back("PMR");
ordinary_data.emplace_back("PMR");
std::cout << std::boolalpha
<< "PMR vector uses arena: "
<< (pmr_data.get_allocator().resource() == &arena) << '\n'
<< "PMR vector element uses arena: "
<< (pmr_data.front().get_allocator().resource() == &arena) << '\n'
<< "Ordinary vector element uses default resource: "
<< (ordinary_data.front().get_allocator().resource() ==
std::pmr::get_default_resource()) << '\n';
}Resultado
PMR vector uses arena: true PMR vector element uses arena: true Ordinary vector element uses default resource: true
La aserción estática comprueba el tipo de asignador del vector ordinario. Los tres resultados `true` confirman la identidad de los recursos, no que se haya asignado memoria para los caracteres: una cadena corta puede caber en su propio objeto.
Lecciones relacionadas
- C++ · Lección 18 · Avanzado · Versión: 3
Fuentes
- Header <vector> synopsis [vector.syn]
- Header <string> synopsis [string.syn]
- Header <cstddef> synopsis [cstddef.syn]
- Class template polymorphic_allocator [mem.poly.allocator.class]
- Allocator-aware containers [container.alloc.reqmts]
- Class monotonic_buffer_resource [mem.res.monotonic.buffer]
- Access to program-wide memory_resource objects [mem.res.global]
- N4950: Working Draft, Standard for Programming Language C++