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

CKTIS / C++

std::println — saída formatada com uma nova linha

std::println de <print> formata os argumentos, escreve o resultado e acrescenta uma nova linha. Por predefinição, utiliza stdout; uma sobrecarga que aceita FILE* permite escolher outro fluxo de saída.

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

Sintaxe

#include <print>
std::println("format", args...);
std::println(stream, "format", args...);

std::println é uma função da biblioteca padrão C++23 declarada em <print>. A chamada std::println("format", args...) escreve texto formatado em stdout e acrescenta \n. Devolve void. Ao contrário de std::print, termina automaticamente o texto com uma nova linha; isso não garante, no entanto, que o buffer seja esvaziado em cada chamada.

Os campos {} consomem os argumentos sucessivos. Depois dos dois-pontos pode surgir uma especificação de formato: {:04d} pede um número inteiro decimal num campo com, pelo menos, quatro caracteres, preenchido com zeros. No exemplo, 42 passa a 0042; um número maior não é truncado.

A forma std::println(stream, "format", args...) recebe como primeiro argumento um FILE* válido que aponta para um fluxo de saída. Erros de escrita podem causar std::system_error; a formatação e a alocação também podem lançar exceções.

É necessário um compilador e uma biblioteca padrão com suporte para <print>; a opção C++23, por si só, não comprova a disponibilidade. Versão da entrada: C++23; opção do compilador no repositório, ambiente de execução de produção não confirmado. As fontes fornecidas descrevem o projeto de norma em evolução, que pode incluir adições posteriores a C++23.

Exemplos

#include <print>

int main() {
    std::println("{}: {:04d}", "Score", 42);
}

Resultado

Score: 0042

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