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.