CKTIS / C++
std::pmr::string — reťazec s polymorfným alokátorom
std::pmr::string je špecializácia std::basic_string, ktorá používa std::pmr::polymorphic_allocator<char>. Umožňuje vybrať pamäťový zdroj počas behu programu bez zmeny typu reťazca.
Verzia: 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, deklarovaný v <string>, je alias pre std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>. Poskytuje operácie s reťazcami, napríklad append() a size(), ale je to iný typ než std::string, ktorý používa std::allocator<char>.
Ak chcete nastaviť zdroj, vložte <memory_resource> a pri vytváraní reťazca odovzdajte ukazovateľ na zdroj. Alokátor smeruje požiadavky na pamäť do tohto zdroja. Alokátor vytvorený predvoleným konštruktorom používa zdroj, ktorý vráti std::pmr::get_default_resource(). Presunový konštruktor bez argumentu určujúceho alokátor naopak zachováva alokátor zdrojového reťazca, a preto môže naďalej používať iný než predvolený zdroj. Samotné použitie std::pmr::string nezaručuje ani absenciu alokácií na halde, ani konkrétny počet alokácií.
Reťazec zdroj nevlastní. Zdroj musí zostať dostupný tak dlho, ako ho reťazec môže používať, aj počas jeho ničenia. V príklade sa resource vytvorí pred text, a preto sa zničí až po ňom. std::pmr::monotonic_buffer_resource uvoľňuje nahromadenú pamäť spoločne; jednotlivé uvoľnenia nič nerobia. Nevolajte release(), kým živý reťazec stále používa pridelenú pamäť.
Príklad vytvorí 40 znakov, pripojí ! a vypíše dĺžku a výsledok kontroly totožnosti zdroja. Očakávaný výstup je 41 a potom true, na samostatných riadkoch. Zobrazený kód bol bez zmien skompilovaný s príznakom C++23 a spustený v izolovanom prostredí. Overila sa presná zhoda jeho štandardného výstupu (stdout) s očakávaným výstupom. Tým sa nepotvrdzuje podpora v produkčnom prostredí na spúšťanie programov. Prepojený pracovný návrh sa priebežne aktualizuje a nie je zmrazený ako C++23.
Prí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ýsledok
41 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.