std::basic_ostream<CharT,Traits>::operator<<

basic_ostream& operator<<( bool value );

basic_ostream& operator<<( long value );

basic_ostream& operator<<( unsigned long value );

basic_ostream& operator<<( long long value );

basic_ostream& operator<<( unsigned long long value );

basic_ostream& operator<<( double value );

basic_ostream& operator<<( long double value );

basic_ostream& operator<<( const void* value );

basic_ostream& operator<<( const volatile void* value );

basic_ostream& operator<<( std::nullptr_t );

basic_ostream& operator<<( short value );

basic_ostream& operator<<( int value );

basic_ostream& operator<<( unsigned short value );

basic_ostream& operator<<( unsigned int value );

basic_ostream& operator<<( float value );

basic_ostream& operator<<( /* extended-floating-point-type */ value );

basic_ostream& operator<<( std::basic_streambuf<CharT, Traits>* sb );

basic_ostream& operator<<(
    std::ios_base& (*func)(std::ios_base&) );

basic_ostream& operator<<(
    std::basic_ios<CharT, Traits>& (*func)(std::basic_ios<CharT, Traits>&) );

basic_ostream& operator<<(
    std::basic_ostream<CharT, Traits>& (*func)
        (std::basic_ostream<CharT, Traits>&) );

Вставляет данные в поток.

• static_cast<long>(static_cast<unsigned short>(value)), если flags() & std::ios_base::basefield равно std::ios_base::oct или std::ios_base::hex, либо
• static_cast<long>(value) в противном случае.

• static_cast<long>(static_cast<unsigned int>(value)), если flags() & std::ios_base::basefield равно std::ios_base::oct или std::ios_base::hex, либо
• static_cast<long>(value) в противном случае.

• Если ранг меньше или равен рангу double, вставляет static_cast<double>(value), как в (6).
• В противном случае, если ранг меньше или равен рангу longdouble, вставляет static_cast<long double>(value), как в (7).
• В противном случае вызов этой перегрузки поддерживается условно, а её семантика определяется реализацией.

Параметры

Возвращаемое значение

Примечания

Перегрузок для указателей на нестатические члены, указателей на volatile-объекты,(до C++23) и указателей на функции (за исключением тех, чьи сигнатуры принимаются перегрузками (18-20)) нет.

• Попытка вывести такие объекты вызывает неявное преобразование к bool, и для любого ненулевого значения указателя выводится значение 1 (если только не установлен boolalpha; в этом случае выводится true).

Символьные аргументы и аргументы-строки символов (например, типа char или constchar*) обрабатываются свободными перегрузками operator<<.

• Попытка вывести символ с использованием синтаксиса вызова функции-члена (например, std::cout.operator<<('c');) вызывает одну из перегрузок (2-5) или (11-14) и выводит числовое значение.
• Попытка вывести строку символов с использованием синтаксиса вызова функции-члена вызывает перегрузку (8) и выводит значение указателя.

Перегрузка (10) была добавлена в результате разрешения проблемы LWG 2221, но ни в одной реализации стандартной библиотеки она не реализована в режимах C++11/14.

Пример

#include <iomanip>
#include <iostream>
#include <sstream>

int fun() { return 42; }

int main()
{
    std::istringstream input(" \"Some text.\" ");
    double f = 3.14;
    bool b = true;
    
    std::cout
        << fun()          // int overload (12)
        << ' '            // non-member overload
        << std::boolalpha // function overload (18)
        << b              // bool overload (1)
        << " "            // non-member overload
        << std::fixed     // function overload (18) again
        << f              // double overload (6)
        << input.rdbuf()  // streambuf overload
        << fun            // bool overload (1): there's no overload for int(*)()
        << std::endl;     // function overload (18) again
    
    int x = 0;
    int* p1 = &x;
    volatile int* p2 = &x;
    std::cout
        << "p1: " << p1 << '\n'  // `const void*` overload, prints address
        << "p2: " << p2 << '\n'; // before C++23 (P1147): bool overload :), because
            // operator<<(const void*) is not a match, as it discards the `volatile`
            // qualifier. To fix this, C++23 adds `const volatile void*` overload (9),
            // that prints the address as expected.
}

42 true 3.140000 "Some text." true
p1: 0x7ffcea766600
p2: 0x7ffcea766600

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также