Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::pmr::string — uma cadeia de caracteres com um alocador polimórfico

std::pmr::string é uma especialização de std::basic_string que utiliza std::pmr::polymorphic_allocator<char>. Permite selecionar um recurso de memória em tempo de execução sem alterar o tipo da cadeia de caracteres.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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, declarado em <string>, é um alias de std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>. Disponibiliza operações de cadeia de caracteres, como append() e size(), mas é um tipo diferente de std::string, que utiliza std::allocator<char>.

Para configurar um recurso, inclua <memory_resource> e passe um ponteiro para o recurso ao construir a cadeia de caracteres. O alocador encaminha os pedidos de memória para esse recurso. Um alocador construído com o construtor predefinido utiliza o recurso devolvido por std::pmr::get_default_resource(). Já a construção por movimento sem um argumento de alocador conserva o alocador da cadeia de origem e pode, por isso, manter um recurso diferente do predefinido. A utilização de std::pmr::string, por si só, não garante a ausência de alocações na heap nem um número específico de alocações.

A cadeia de caracteres não é proprietária do recurso. Este tem de permanecer disponível enquanto a cadeia o puder utilizar, incluindo durante a destruição. No exemplo, resource é construído antes de text e, por isso, é destruído depois. std::pmr::monotonic_buffer_resource liberta em conjunto a memória acumulada; as desalocações individuais não fazem nada. Não chame release() enquanto uma cadeia de caracteres viva ainda utilizar a memória alocada.

O exemplo cria 40 caracteres, acrescenta ! e imprime o comprimento e o resultado da verificação da identidade do recurso. O resultado esperado é 41, seguido de true, em linhas separadas. O código apresentado foi compilado sem alterações com uma opção C++23 e executado num ambiente isolado. Verificou-se que a saída padrão (stdout) correspondia exatamente à saída esperada. Isto não confirma o suporte em ambientes de execução de produção. O rascunho de trabalho associado é mantido e não está congelado como C++23.

Exemplos

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

Resultado

41
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes