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.