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).
• В противном случае, если степень меньше или равна степени long double, вставляет static_cast<long double>(value) так же, как в (7).
• В противном случае, вызов этой перегрузки условно поддерживается с реализуемыми семантиками.

Параметры

Значение возврата

Примечания

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

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

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

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

Пример

#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++.

См. также