Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

Operador de inserción en flujo <<

El operador << escribe valores en un flujo de salida. Aprende la diferencia entre las sobrecargas miembro y las funciones no miembro, y cómo admitir un tipo personalizado sin perder la inserción encadenada.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

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

La expresión stream << value selecciona una sobrecarga de inserción en un flujo de salida. std::ostream es un alias de std::basic_ostream<char>. El símbolo std::ostream::operator<< representa las sobrecargas miembro, incluidas las destinadas a números y a punteros a funciones manipuladoras. Aquí, operator<<(std::ostream&, ...) representa una familia de funciones no miembro, no la declaración de una función variádica: ... es un marcador descriptivo para parámetros adicionales. Las sobrecargas estándar para caracteres y cadenas terminadas en nulo son funciones no miembro.

Las sobrecargas usadas en el ejemplo devuelven una referencia al mismo flujo, por lo que stream << first << second funciona como (stream << first) << second. La inserción no añade espacios ni saltos de línea automáticamente. La llamada explícita stream.operator<<('A') evita las sobrecargas no miembro para caracteres y selecciona una sobrecarga numérica en lugar de imprimir el carácter.

Para un tipo personalizado, define una función no miembro std::ostream& operator<<(std::ostream& os, const T& value) en el mismo espacio de nombres que el tipo, no en std. Devuelve os, normalmente devolviendo la expresión de inserción completa. El ejemplo aplica este patrón a Point y añade explícitamente \n.

La salida depende del estado de formato del flujo; por ejemplo, los manipuladores pueden cambiar el formato numérico. Devolver una referencia no confirma que la salida haya tenido éxito: comprueba el estado del flujo, como hace el ejemplo. Las fuentes proporcionadas son el borrador actual del estándar, no un texto C++23 definitivo; una compilación local con una opción C++23 no demuestra la compatibilidad con el entorno de ejecución de producción.

Ejemplos

#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)

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes