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

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

Параметры

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

Примечания

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

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

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

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

Перегрузка (10) была добавлена резолюцией LWG issue 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 (12)
        << ' '            // внешняя перегрузка
        << std::boolalpha // перегрузка для функции (18)
        << b              // перегрузка для bool (1)
        << " "            // внешняя перегрузка
        << std::fixed     // перегрузка для функции (18) снова
        << f              // перегрузка для double (6)
        << input.rdbuf()  // перегрузка для streambuf
        << fun            // перегрузка для bool (1): нет перегрузки для int(*)()
        << std::endl;     // перегрузка для функции (18) снова
    int x = 0;
    int* p1 = &x;
    volatile int* p2 = &x;
    std::cout
        << "p1: " << p1 << '\n'  // перегрузка `const void*`, выводит адрес
        << "p2: " << p2 << '\n'; // до C++23 (P1147): перегрузка для bool :), потому что
            // operator<<(const void*) не подходит, так как отбрасывает квалификатор `volatile`
            // Для исправления этого C++23 добавляет перегрузку `const volatile void*` (9),
            // которая выводит адрес, как и ожидается.
}

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

Отчёты о дефектах

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

Смотрите также