CKTIS / C++
std::pmr::string — een string met een polymorfe allocator
std::pmr::string is een specialisatie van std::basic_string die std::pmr::polymorphic_allocator<char> gebruikt. Hiermee kun je tijdens runtime een geheugenresource kiezen zonder het stringtype te wijzigen.
Versie: 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, gedeclareerd in <string>, is een alias voor std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>. Het biedt stringbewerkingen zoals append() en size(), maar is een ander type dan std::string, dat std::allocator<char> gebruikt.
Neem <memory_resource> op en geef bij het construeren van de string een pointer naar de resource mee om een resource in te stellen. De allocator stuurt geheugenaanvragen naar die resource. Een allocator die met de standaardconstructor is aangemaakt, gebruikt de resource die std::pmr::get_default_resource() teruggeeft. De move-constructor zonder allocatorargument neemt daarentegen de allocator van de bronstring over en kan zo een andere resource dan de standaardresource behouden. Het gebruik van std::pmr::string garandeert op zichzelf noch dat er geen heapallocaties plaatsvinden, noch een bepaald aantal allocaties.
De string bezit de resource niet. De resource moet beschikbaar blijven zolang de string die kan gebruiken, ook tijdens het vernietigen ervan. In het voorbeeld wordt resource vóór text gemaakt en dus erna vernietigd. std::pmr::monotonic_buffer_resource geeft het verzamelde geheugen in één keer vrij; afzonderlijke deallocaties doen niets. Roep release() niet aan zolang een levende string het toegewezen geheugen nog gebruikt.
Het voorbeeld maakt 40 tekens, voegt ! toe en drukt de lengte en het resultaat van de controle op resource-identiteit af. De verwachte uitvoer is 41, gevolgd door true, op afzonderlijke regels. De getoonde code is ongewijzigd gecompileerd met een C++23-vlag en uitgevoerd in een geïsoleerde omgeving. Daarbij is gecontroleerd of de standaarduitvoer (stdout) exact overeenkwam met de verwachte uitvoer. Dit bevestigt geen ondersteuning in productieomgevingen. Het gekoppelde werkdocument wordt bijgehouden en is niet bevroren als C++23.
Voorbeelden
#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';
}
Resultaat
41 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.