WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::pmr::vector: Speicherressourcen und Elementallokatoren

Wähle eine Speicherressource für einen PMR-Vektor und erfahre, wann seine Elemente dieselbe Ressource erhalten und wie sich ein gewöhnlicher Vektor davon unterscheidet.

Version: ISO C++23; implementation support may vary

Syntax

#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> aus <vector> ist ein Alias für std::vector<T, std::pmr::polymorphic_allocator<T>>, keine eigene Containerklasse. std::pmr::string aus <string> ist std::basic_string für char mit std::pmr::polymorphic_allocator<char>. Beide Aliase und std::byte wurden in C++17 eingeführt und gehören zu C++23; die Unterstützung kann je nach Implementierung variieren.

Ein polymorpher Allokator leitet Speicheranfragen an eine zur Laufzeit gewählte std::pmr::memory_resource weiter. Mit data{&arena} wählst du arena ausdrücklich für den Elementspeicher des Vektors. Ein standardmäßig konstruierter polymorpher Allokator bezieht die aktuelle Ressource über std::pmr::get_default_resource(). Das ist nicht dasselbe wie std::allocator<T>, der Standardallokatortyp eines gewöhnlichen std::vector<T>.

Bei emplace_back("PMR") auf einem std::pmr::vector<std::pmr::string> erhält der neue String durch die allokatorbewusste Konstruktion die Ressource des Vektors. Er nutzt sie, falls er separaten Speicher für Zeichen benötigt. Steht DATA für std::pmr::string, verwendet ein gewöhnlicher std::vector<DATA> weiterhin std::allocator<DATA> für seinen Elementspeicher. Bei diesem Aufruf übergibt er dem String-Konstruktor keine Ressource; der String erhält daher die PMR-Standardressource. Umgekehrt verwendet ein std::string nicht allein deshalb PMR, weil er Element eines PMR-Vektors ist.

std::byte aus <cstddef> ist ein Enum mit eigenem Gültigkeitsbereich und dem zugrunde liegenden Typ unsigned char. Ein Array daraus dient hier als Rohspeicher für eine std::pmr::monotonic_buffer_resource aus <memory_resource>. Reicht der verfügbare Platz für eine Anfrage nicht aus, fordert die Ressource einen weiteren Block bei ihrer vorgelagerten Ressource an. Ist diese std::pmr::null_memory_resource(), löst die Anfrage stattdessen std::bad_alloc aus.

Der Vektor besitzt die Ressource nicht. Deklariere Puffer, Ressource und Container in dieser Reihenfolge, damit der Container zuerst zerstört wird. Rufe release() nicht auf, solange Objekte noch von Speicher abhängen, den die Ressource bereitgestellt hat. Eine monotone Ressource gewinnt bei einzelnen Freigaben keinen Speicherplatz zurück.

Beispiele

#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';
}

Ergebnis

PMR vector uses arena: true
PMR vector element uses arena: true
Ordinary vector element uses default resource: true

Die statische Prüfung kontrolliert den Allokatortyp des gewöhnlichen Vektors. Die drei `true`-Ergebnisse bestätigen die Identität der Ressourcen, nicht die Zuweisung von Zeichenspeicher: Ein kurzer String kann in seinem eigenen Objekt Platz finden.

Zugehörige Lektionen

  • C++ · Lektion 18 · Fortgeschritten · Version: 3

Quellen