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

CKTIS / C++

Operador de inserção em fluxo <<

O operador << escreve valores num fluxo de saída. Aprende a diferença entre sobrecargas membro e funções não membro, e como suportar um tipo personalizado mantendo a inserção encadeada.

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

Sintaxe

stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);

A expressão stream << value seleciona uma sobrecarga de inserção num fluxo de saída. std::ostream é um alias de std::basic_ostream<char>. O símbolo std::ostream::operator<< designa as sobrecargas membro, incluindo as destinadas a números e a ponteiros para funções manipuladoras. Aqui, operator<<(std::ostream&, ...) designa uma família de funções não membro, não a declaração de uma função variádica: ... é um marcador descritivo para parâmetros adicionais. As sobrecargas padrão para caracteres e cadeias terminadas em nulo são funções não membro.

As sobrecargas utilizadas no exemplo devolvem uma referência ao mesmo fluxo, pelo que stream << first << second funciona como (stream << first) << second. A inserção não acrescenta automaticamente espaços nem mudanças de linha. A chamada explícita stream.operator<<('A') contorna as sobrecargas não membro para caracteres e seleciona uma sobrecarga numérica, em vez de escrever o carácter.

Para um tipo personalizado, define uma função não membro std::ostream& operator<<(std::ostream& os, const T& value) no mesmo espaço de nomes que o tipo, não em std. Devolve os, normalmente devolvendo a expressão de inserção completa. O exemplo aplica este padrão a Point e acrescenta explicitamente \n.

A saída depende do estado de formatação do fluxo; por exemplo, os manipuladores podem alterar a formatação numérica. Devolver uma referência não confirma que a escrita foi bem-sucedida: verifica o estado do fluxo, como faz o exemplo. As fontes fornecidas são o rascunho atual da norma, não um texto C++23 fixo; uma compilação local com uma opção C++23 não demonstra compatibilidade com o ambiente de execução de produção.

Exemplos

#include <iostream>

struct Point {
    int x;
    int y;
};

std::ostream& operator<<(std::ostream& os, const Point& point) {
    return os << '(' << point.x << ", " << point.y << ')';
}

int main() {
    const Point point{2, 3};
    std::cout << "Point: " << point << '\n';
    return std::cout ? 0 : 1;
}

Resultado

Point: (2, 3)

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