WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::pmr::string — String mit polymorphem Allocator

std::pmr::string ist eine Spezialisierung von std::basic_string, die std::pmr::polymorphic_allocator<char> verwendet. Damit lässt sich zur Laufzeit eine Speicherressource auswählen, ohne den Stringtyp zu ändern.

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

Syntax

#include <string>
#include <memory_resource>

// Equivalent underlying type:
// std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>
std::pmr::string text{&resource};

std::pmr::string, deklariert in <string>, ist ein Alias für std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>. Er bietet String-Operationen wie append() und size(), ist aber ein anderer Typ als std::string, der std::allocator<char> verwendet.

Um eine Ressource festzulegen, binde <memory_resource> ein und übergib beim Erzeugen des Strings einen Zeiger auf die Ressource. Der Allocator leitet Speicheranforderungen an diese Ressource weiter. Ein mit dem Standardkonstruktor erzeugter Allocator verwendet die von std::pmr::get_default_resource() zurückgegebene Ressource. Der Move-Konstruktor ohne Allocator-Argument übernimmt dagegen den Allocator des Quellstrings und kann so eine vom Standard abweichende Ressource beibehalten. Die Verwendung von std::pmr::string allein garantiert weder, dass keine Heap-Allokationen stattfinden, noch eine bestimmte Anzahl von Allokationen.

Der String besitzt seine Ressource nicht. Die Ressource muss verfügbar bleiben, solange der String sie verwenden kann, auch während seiner Zerstörung. Im Beispiel wird resource vor text erzeugt und daher danach zerstört. std::pmr::monotonic_buffer_resource gibt den angesammelten Speicher gemeinsam frei; einzelne Freigaben bewirken nichts. Rufe release() nicht auf, solange ein lebender String den zugewiesenen Speicher noch verwendet.

Das Beispiel erzeugt 40 Zeichen, hängt ! an und gibt die Länge sowie das Ergebnis der Prüfung der Ressourcenidentität aus. Die erwartete Ausgabe lautet 41 und danach true, jeweils in einer eigenen Zeile. Der angezeigte Code wurde unverändert mit einem C++23-Flag kompiliert und in einer isolierten Umgebung ausgeführt. Dabei wurde die Standardausgabe (stdout) auf exakte Übereinstimmung mit der erwarteten Ausgabe geprüft. Das bestätigt keine Unterstützung in einer Produktionsumgebung. Der verlinkte Arbeitsentwurf wird weiterentwickelt und ist nicht als C++23 eingefroren.

Beispiele

#include <iostream>
#include <memory_resource>
#include <string>

int main() {
    std::pmr::monotonic_buffer_resource resource;
    std::pmr::string text(40, 'x', &resource);
    text.append("!");

    std::cout << text.size() << '\n';
    std::cout << std::boolalpha
              << (text.get_allocator().resource() == &resource)
              << '\n';
}

Ergebnis

41
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen