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

CKTIS / C++

Operador de inserção num fluxo de saída (`<<`)

`<<` escreve valores num fluxo de saída ou altera a sua formatação. Os tipos dos operandos distinguem a inserção do deslocamento de bits para a esquerda.

Versão: ISO C++23; implementation support may vary

Sintaxe

out << value;
out << first << second;          // (out << first) << second
out << std::boolalpha << flag;
out << (1u << 3);                // insert the result of a built-in left shift

// Conventional non-member overload in the namespace of T:
std::ostream& operator<<(std::ostream& out, const T& value);

Em C++23, std::cout << x insere um valor num fluxo de saída, ao passo que 1u << 3 é um deslocamento de bits para a esquerda incorporado na linguagem. O símbolo é o mesmo, mas os tipos dos operandos e as operações são diferentes. Na gramática de C++, << é associativo à esquerda, pelo que out << a << b se agrupa como (out << a) << b, independentemente do tipo de retorno da sobrecarga selecionada. Para um lvalue out do tipo std::ostream, as sobrecargas habituais devolvem uma referência std::ostream& para o mesmo fluxo, permitindo que a inserção seguinte escreva nesse fluxo. Não são acrescentados espaços nem mudanças de linha automaticamente.

Os números usam sobrecargas de funções-membro; char e o texto usam sobrecargas de funções não membro. Prefere out << x a out.operator<<(x), pois a chamada explícita da função-membro ignora as funções não membro. Inserir um const char* exige um ponteiro para uma cadeia válida terminada por um carácter nulo. std::string e std::string_view usam o seu comprimento, pelo que um carácter nulo no interior não termina a saída. std::string_view não é proprietário dos dados: os caracteres referenciados têm de permanecer válidos durante toda a inserção.

A formatação é uma propriedade do fluxo. Tanto out << std::boolalpha como out.setf(std::ios::boolalpha) ativam os nomes dos valores booleanos segundo a configuração regional (true e false na configuração clássica). A opção continua ativa até ser desativada, por exemplo com std::noboolalpha. Em contrapartida, std::setw(n) define uma largura mínima de campo que as sobrecargas habituais para caracteres, cadeias e números repõem a zero após a utilização.

out << '\n' insere uma mudança de linha sem pedir explicitamente o esvaziamento do buffer. std::endl insere uma mudança de linha e chama flush(). Receber o fluxo de volta não prova que a escrita foi bem-sucedida: verifica depois if (!out). Uma falha pode ativar failbit ou badbit e, consoante a máscara de exceções do fluxo, provocar uma exceção.

Para um tipo próprio T, define um operator<<(std::ostream&, const T&) não membro no espaço de nomes do tipo, não em std. A pesquisa dependente dos argumentos (ADL) pode encontrá-lo aí. Escreve no fluxo recebido e devolve-o por referência para permitir o encadeamento.

Exemplos

#include <ios>
#include <iostream>
#include <locale>
#include <ostream>
#include <string_view>

namespace report {
struct Result {
    std::string_view label;
    bool ok;
};

std::ostream& operator<<(std::ostream& out, const Result& result) {
    return out << result.label << ": " << result.ok;
}
} // namespace report

int main() {
    std::cout.imbue(std::locale::classic());
    std::cout.setf(std::ios::boolalpha);
    const report::Result result{std::string_view{"ABC", 2}, true};
    std::cout << result << ' ' << false << '\n';
    std::cout << "shift=" << (1u << 3) << '\n';
}

Resultado

AB: true false
shift=8

`report::Result` apresenta `AB` porque a vista abrange apenas os dois primeiros caracteres de `ABC`. A opção `boolalpha` aplica-se dentro da sobrecarga personalizada e ao `false` seguinte. Na segunda linha, os parênteses separam o deslocamento que produz `8` da inserção do resultado.

Lições relacionadas

  • C++ · Lição 1 · Avançado · Versão: 3
  • C++ · Lição 2 · Avançado · Versão: 3
  • C++ · Lição 3 · Avançado · Versão: 3
  • C++ · Lição 4 · Avançado · Versão: 3
  • C++ · Lição 5 · Avançado · Versão: 3
  • C++ · Lição 6 · Avançado · Versão: 3
  • C++ · Lição 7 · Avançado · Versão: 3
  • C++ · Lição 8 · Avançado · Versão: 3
  • C++ · Lição 9 · Avançado · Versão: 3
  • C++ · Lição 10 · Avançado · Versão: 3
  • C++ · Lição 11 · Avançado · Versão: 3
  • C++ · Lição 12 · Avançado · Versão: 3
  • C++ · Lição 13 · Avançado · Versão: 3
  • C++ · Lição 14 · Avançado · Versão: 3
  • C++ · Lição 15 · Avançado · Versão: 3
  • C++ · Lição 16 · Avançado · Versão: 3
  • C++ · Lição 17 · Avançado · Versão: 3
  • C++ · Lição 18 · Avançado · Versão: 3
  • C++ · Lição 19 · Avançado · Versão: 3
  • C++ · Lição 20 · Avançado · Versão: 3
  • C++ · Lição 21 · Avançado · Versão: 3
  • C++ · Lição 22 · Avançado · Versão: 3
  • C++ · Lição 23 · Avançado · Versão: 3
  • C++ · Lição 24 · Avançado · Versão: 3
  • C++ · Lição 25 · Avançado · Versão: 3
  • C++ · Lição 26 · Avançado · Versão: 3
  • C++ · Lição 27 · Avançado · Versão: 3
  • C++ · Lição 28 · Avançado · Versão: 3
  • C++ · Lição 29 · Avançado · Versão: 3
  • C++ · Lição 30 · Avançado · Versão: 3
  • C++ · Lição 31 · Avançado · Versão: 3
  • C++ · Lição 32 · Avançado · Versão: 3
  • C++ · Lição 33 · Avançado · Versão: 3
  • C++ · Lição 34 · Avançado · Versão: 3
  • C++ · Lição 35 · Avançado · Versão: 3
  • C++ · Lição 36 · Avançado · Versão: 3
  • C++ · Lição 37 · Avançado · Versão: 3
  • C++ · Lição 38 · Avançado · Versão: 3
  • C++ · Lição 39 · Avançado · Versão: 3
  • C++ · Lição 40 · Avançado · Versão: 3
  • C++ · Lição 41 · Avançado · Versão: 3
  • C++ · Lição 42 · Avançado · Versão: 3
  • C++ · Lição 43 · Avançado · Versão: 3
  • C++ · Lição 44 · Avançado · Versão: 3
  • C++ · Lição 45 · Avançado · Versão: 3
  • C++ · Lição 46 · Avançado · Versão: 3
  • C++ · Lição 47 · Avançado · Versão: 3
  • C++ · Lição 48 · Avançado · Versão: 3
  • C++ · Lição 49 · Avançado · Versão: 3
  • C++ · Lição 50 · Avançado · Versão: 3
  • C++ · Lição 51 · Avançado · Versão: 3
  • C++ · Lição 52 · Avançado · Versão: 3
  • C++ · Lição 53 · Avançado · Versão: 3
  • C++ · Lição 54 · Avançado · Versão: 3
  • C++ · Lição 55 · Avançado · Versão: 3
  • C++ · Lição 56 · Avançado · Versão: 3
  • C++ · Lição 57 · Avançado · Versão: 3
  • C++ · Lição 58 · Avançado · Versão: 3
  • C++ · Lição 59 · Avançado · Versão: 3
  • C++ · Lição 60 · Avançado · Versão: 3

Fontes