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

CKTIS / C++

std::print — saída formatada

std::print de <print> escreve dados formatados em stdout ou num fluxo FILE* especificado. Utiliza campos de substituição como {} e não acrescenta automaticamente uma mudança de linha.

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

Sintaxe

#include <print>
std::print(fmt, args...);
std::print(stream, fmt, args...);

std::print é uma função da biblioteca-padrão C++23 disponibilizada por <print>. A chamada std::print(fmt, args...) escreve em stdout; a sobrecarga std::print(stream, fmt, args...) aceita um ponteiro FILE* válido para um fluxo C de saída. A função devolve void, e não o texto resultante.

Os campos {} no formato são substituídos pelos argumentos sucessivos. Para um literal de formato, a validade do formato relativamente aos tipos dos argumentos é verificada em tempo de compilação. Não é a sintaxe de printf: utiliza campos entre chavetas em vez de especificadores como %d.

std::print não acrescenta uma mudança de linha: inclui \n no formato, como no exemplo. Em contrapartida, std::println acrescenta uma mudança de linha. Uma falha de escrita pode lançar std::system_error; também são possíveis exceções de formatação e de alocação.

Tanto o compilador como a biblioteca-padrão têm de suportar <print>. Uma opção de compilação C++23 no repositório, por si só, não comprova o funcionamento no ambiente de execução de produção. As fontes fornecidas são um projeto de norma em evolução e podem conter adições posteriores a C++23; esta entrada limita-se à interface C++23.

Exemplos

#include <print>

int main() {
    const int count = 3;
    std::print("Items: {}; total: {}\n", count, count * 7);
}

Resultado

Items: 3; total: 21

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