Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::pmr::string — napis z polimorficznym alokatorem

std::pmr::string to specjalizacja std::basic_string używająca std::pmr::polymorphic_allocator<char>. Pozwala wybrać zasób pamięci podczas działania programu bez zmiany typu napisu.

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

Składnia

#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, zadeklarowany w <string>, jest aliasem std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>. Udostępnia operacje napisu, takie jak append() i size(), lecz jest innym typem niż std::string, który używa std::allocator<char>.

Do skonfigurowania zasobu dołącz <memory_resource> i przekaż wskaźnik do zasobu przy konstruowaniu napisu. Alokator kieruje żądania pamięci do tego zasobu. Alokator skonstruowany domyślnie używa zasobu zwróconego przez std::pmr::get_default_resource(). Natomiast konstruktor przenoszący bez argumentu alokatora zachowuje alokator napisu źródłowego, a więc może nadal korzystać z zasobu innego niż domyślny. Samo użycie std::pmr::string nie gwarantuje braku alokacji na stercie ani określonej liczby alokacji.

Napis nie przejmuje własności zasobu. Zasób musi pozostać dostępny tak długo, jak napis może go używać, także podczas niszczenia. W przykładzie resource powstaje przed text, więc jest niszczony po nim. std::pmr::monotonic_buffer_resource zwalnia zgromadzoną pamięć zbiorczo; pojedyncze zwolnienia nic nie robią. Nie wywołuj release(), gdy żywy napis nadal korzysta z przydzielonej pamięci.

Przykład tworzy 40 znaków, dopisuje ! i wypisuje długość oraz wynik sprawdzenia tożsamości zasobu. Oczekiwane wyjście to 41, a następnie true, w osobnych wierszach. Wyświetlony kod skompilowano bez zmian z flagą C++23 i uruchomiono w odizolowanym środowisku, a jego standardowe wyjście (stdout) dokładnie porównano z oczekiwanym wynikiem. Nie potwierdza to obsługi w produkcyjnym środowisku uruchomieniowym. Podlinkowany szkic standardu jest aktualizowany, a nie zamrożony jako C++23.

Przykłady

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

Wynik

41
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła