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

CKTIS / C++

Operador de inserción en un flujo de salida (`<<`)

`<<` escribe valores en un flujo de salida o modifica su formato. Los tipos de los operandos distinguen la inserción del desplazamiento de bits a la izquierda.

Versión: ISO C++23; implementation support may vary

Sintaxis

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

En C++23, std::cout << x inserta un valor en un flujo de salida, mientras que 1u << 3 es un desplazamiento de bits a la izquierda incorporado en el lenguaje. El símbolo es el mismo, pero los tipos de los operandos y las operaciones son distintos. Según la gramática de C++, << es asociativo por la izquierda, por lo que out << a << b se agrupa como (out << a) << b, con independencia del tipo de retorno de la sobrecarga seleccionada. Con un lvalue out de tipo std::ostream, las sobrecargas habituales devuelven una referencia std::ostream& al mismo flujo, lo que permite que la siguiente inserción escriba en él. No se añaden espacios ni saltos de línea automáticamente.

Los números usan sobrecargas miembro; char y el texto usan sobrecargas no miembro. Usa out << x en lugar de out.operator<<(x): la llamada explícita al miembro omite las funciones no miembro. Insertar un const char* requiere un puntero a una cadena válida terminada en nulo. std::string y std::string_view usan su longitud, así que un carácter nulo interno no detiene la salida. std::string_view no posee los datos: los caracteres referenciados deben seguir siendo válidos durante toda la inserción.

El formato pertenece al flujo. Tanto out << std::boolalpha como out.setf(std::ios::boolalpha) activan los nombres de los booleanos según la configuración regional (true y false en la clásica). El indicador permanece activo hasta que se desactiva, por ejemplo con std::noboolalpha. En cambio, std::setw(n) fija una anchura mínima de campo que las sobrecargas habituales para caracteres, cadenas y números restablecen a cero después de usarla.

out << '\n' inserta un salto de línea sin pedir expresamente el vaciado del búfer. std::endl inserta un salto de línea y llama a flush(). Recuperar el flujo no demuestra que la escritura haya tenido éxito: comprueba luego if (!out). Un fallo puede activar failbit o badbit y, según la máscara de excepciones del flujo, provocar una excepción.

Para un tipo propio T, define un operator<<(std::ostream&, const T&) no miembro en el espacio de nombres del tipo, no en std. La búsqueda dependiente de los argumentos (ADL) puede encontrarlo allí. Escribe en el flujo recibido y devuélvelo por referencia para permitir el encadenamiento.

Ejemplos

#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` muestra `AB` porque la vista solo abarca los dos primeros caracteres de `ABC`. El indicador `boolalpha` se aplica dentro de la sobrecarga personalizada y al `false` siguiente. En la segunda línea, los paréntesis separan el desplazamiento que produce `8` de la inserción del resultado.

Lecciones relacionadas

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

Fuentes