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

CKTIS / C++

std::vformat — formatação com uma cadeia de formato determinada em tempo de execução

std::vformat de <format> cria uma cadeia a partir de uma cadeia de formato e de um pacote de argumentos std::format_args. Aceita um padrão determinado em tempo de execução e assinala formatos inválidos para os argumentos fornecidos através de std::format_error.

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

Sintaxe

#include <format>
std::string std::vformat(std::string_view fmt, std::format_args args);
std::wstring std::vformat(std::wstring_view fmt, std::wformat_args args);
std::string std::vformat(const std::locale& loc, std::string_view fmt, std::format_args args);
std::wstring std::vformat(const std::locale& loc, std::wstring_view fmt, std::wformat_args args);

std::vformat devolve uma nova cadeia em vez de escrever para um fluxo. Aceita uma cadeia de formato e um pacote de argumentos com os tipos apagados. A sobrecarga com std::string_view devolve std::string; a sobrecarga com std::wstring_view usa std::wformat_args e devolve std::wstring. As sobrecargas que recebem std::locale permitem formatar de acordo com as definições regionais.

Em C++23, std::format verifica normalmente a cadeia de formato em tempo de compilação. Em contrapartida, std::vformat aceita um padrão que só está disponível em tempo de execução. Uma sintaxe inválida, um argumento referenciado em falta ou um especificador incompatível com o tipo do argumento provoca std::format_error. Também podem propagar-se exceções dos formatadores e falhas de alocação.

Crie o pacote com std::make_format_args, usando variáveis com nome. Não o trate como proprietário de todos os valores: pode guardar referências aos dados dos argumentos. Esses dados têm de permanecer válidos até ao fim da formatação, e std::format_args, por si só, não prolonga o tempo de vida do armazenamento criado por std::make_format_args. Passar esse armazenamento diretamente à chamada, como no exemplo, evita que seja destruído demasiado cedo.

No exemplo, {} insere label, enquanto {:04d} escreve count em decimal, com uma largura mínima de quatro caracteres e zeros à esquerda. O resultado é item: 0007, seguido de uma mudança de linha. Esta entrada destina-se a C++23; a referência fornecida aponta para um projeto de trabalho em evolução, que pode conter alterações posteriores. Uma opção do compilador num repositório não comprova a disponibilidade da biblioteca no ambiente de produção.

Exemplos

#include <format>
#include <iostream>
#include <string>

int main() {
    std::string pattern = "{}: {:04d}";
    std::string label = "item";
    int count = 7;

    std::string result = std::vformat(
        pattern, std::make_format_args(label, count));
    std::cout << result << '\n';
}

Resultado

item: 0007

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