CKTIS / C++
std::pmr::string — řetězec s polymorfním alokátorem
std::pmr::string je specializace std::basic_string používající std::pmr::polymorphic_allocator<char>. Umožňuje vybrat paměťový zdroj za běhu programu, aniž by se změnil typ řetězce.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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, deklarovaný v <string>, je alias pro std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>. Poskytuje operace s řetězci, například append() a size(), ale jde o jiný typ než std::string, který používá std::allocator<char>.
Chcete-li nastavit zdroj, vložte <memory_resource> a při konstrukci řetězce předejte ukazatel na zdroj. Alokátor směruje požadavky na paměť do tohoto zdroje. Alokátor vytvořený výchozím konstruktorem používá zdroj vrácený funkcí std::pmr::get_default_resource(). Přesunový konstruktor bez argumentu určujícího alokátor naopak zachovává alokátor zdrojového řetězce, a může tak nadále používat jiný než výchozí zdroj. Samotné použití std::pmr::string nezaručuje ani absenci alokací na haldě, ani konkrétní počet alokací.
Řetězec zdroj nevlastní. Zdroj musí zůstat dostupný po celou dobu, kdy jej řetězec může používat, včetně jeho rušení. V příkladu se resource vytvoří před text, a proto se zruší až po něm. std::pmr::monotonic_buffer_resource uvolňuje nahromaděnou paměť najednou; jednotlivá uvolnění nic nedělají. Nevolejte release(), dokud živý řetězec stále používá přidělenou paměť.
Příklad vytvoří 40 znaků, připojí ! a vypíše délku a výsledek kontroly totožnosti zdroje. Očekávaný výstup je 41 a poté true, na samostatných řádcích. Zobrazený kód byl beze změn přeložen s příznakem C++23 a spuštěn v izolovaném prostředí. Ověřilo se, že jeho standardní výstup (stdout) přesně odpovídá očekávanému výstupu. Tím se nepotvrzuje podpora v produkčním běhovém prostředí. Odkazovaný pracovní návrh se průběžně aktualizuje a není zmrazen jako C++23.
Příklady
#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';
}
Výsledek
41 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.