std::basic_ostream::operator<<

<metanoindex/>

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека ввода/вывода

Манипуляторы ввода/вывода

Функции print (C++23)

Ввод/вывод в стиле C

Буферы

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (устарело в C++98)

basic_syncbuf (C++20)

Потоки

Абстракции

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Файловый ввод/вывод

basic_ifstream

basic_ofstream

basic_fstream

Ввод/вывод строк

basic_istringstream

basic_ostringstream

basic_stringstream

Ввод/вывод массивов

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (устарело в C++98)

ostrstream (устарело в C++98)

strstream (устарело в C++98)

Синхронизированный вывод

basic_osyncstream (C++20)

Типы

streamoff

streamsize

fpos

Интерфейс категорий ошибок

iostream_category (C++11)

io_errc (C++11)

 

std::basic_ostream

Глобальные объекты Оригинал: Global objects Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
coutwcout	cerrwcerr	clogwclog
Функции-члены
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
Форматированный ввод Оригинал: Formatted input Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
basic_ostream::operator<<
Неформатированная вход Оригинал: Unformatted input Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
basic_ostream::put
basic_ostream::write
Позиционирование Оригинал: Positioning Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
basic_ostream::tellp
basic_ostream::seekp
Разное Оригинал: Miscellaneous Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
basic_ostream::flush
basic_ostream::swap (C++11)
Член классов Оригинал: Member classes Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
basic_ostream::sentry
Функции, не являющиеся членами
operator<<(std::basic_ostream)

 

<tbody> </tbody>

basic_ostream& operator<<( short value ); basic_ostream& operator<<( unsigned short value );	(1)
basic_ostream& operator<<( int value ); basic_ostream& operator<<( unsigned int value );	(2)
basic_ostream& operator<<( long value ); basic_ostream& operator<<( unsigned long value );	(3)
basic_ostream& operator<<( long long value ); basic_ostream& operator<<( unsigned long long value );	(4)	(начиная с C++11)
basic_ostream& operator<<( float value ); basic_ostream& operator<<( double value ); basic_ostream& operator<<( long double value );	(5)
basic_ostream& operator<<( bool value );	(6)
basic_ostream& operator<<( const void* value );	(7)
basic_ostream& operator<<( std::basic_streambuf<CharT, Traits>* sb);	(8)
basic_ostream& operator<<( basic_ostream& st, std::ios_base& (*func)(std::ios_base&) ); basic_ostream& operator<<( basic_ostream& st, std::basic_ios<CharT,Traits>& (*func)(std::basic_ios<CharT,Traits>&) ); basic_ostream& operator<<( basic_ostream& st, std::basic_ostream& (*func)(std::basic_ostream&) );	(9)

Вставка данных в поток.

Оригинал:

Inserts data into the stream.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(1-7) версии оператора ведут себя, как отформатированные функции вывода и 8) версия ведет себя как неформатированный выходной функции. Эти функции начинается выполнение путем построения объекта типа sentry, который очищает tie()'d выходные буферы при необходимости и проверяет поток ошибок. После завершения строительных работ, если часовой объект возвращается false, функции возвращают не пытаясь никаких выходных данных. Если ошибка появляется во время выходных, отформатированных выходных функций установлены setstate(ios_base::failbit). Если исключение во время выходных, то IOS :: badbit установлен (за исключением подавляется, если (exceptions()&badbit) != 0, в этом случае он выдается повторно)

Оригинал:

The (1-7) versions of the operator behave as formatted output functions, and the 8) version behaves as unformatted output function. These functions begin execution by constructing an object of type sentry, which flushes the tie()'d output buffers if necessary and checks the stream errors. After construction, if the sentry object returns false, the functions return without attempting any output. If an error occurs during output, formatted output functions set setstate(ios_base::failbit). If an exception is thrown during output, then ios::badbit is set (the exception is suppressed unless (exceptions()&badbit) != 0, in which case it is rethrown)

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

1-2)

Если value является short или int, затем бросает его в unsigned short или unsigned int если ios_base::flags() & ios_base::basefield является ios_base::oct или ios_base::hex. После этого бросает в long в любом случае и выходов, а в 3). Если value является unsigned short или unsigned int, бросает в unsigned long и выходов, а в 3)

Оригинал:

If value is short or int, then casts it to unsigned short or unsigned int if ios_base::flags() & ios_base::basefield is ios_base::oct or ios_base::hex. After that, casts to long in any case and outputs as in 3). If value is unsigned short or unsigned int, casts to unsigned long and outputs as in 3)

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

3-4)

Вставки целое значение, вызвав num_put::put(). Если конец файла условием была обнаружена во время выхода (put().failed() == true), устанавливает ios::badbit.

Оригинал:

Inserts an integer value by calling num_put::put(). If the end of file condition was encountered during output (put().failed() == true), sets ios::badbit.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

5)

Вставляет значение с плавающей точкой, вызвав num_put::put() Если конец файла условием была обнаружена во время выхода (put().failed() == true), устанавливает ios::badbit.

Оригинал:

Inserts a floating point value by calling num_put::put() If the end of file condition was encountered during output (put().failed() == true), sets ios::badbit.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

6)

Вставки bool значения по телефону num_put::put() Если конец файла условием была обнаружена во время выхода (put().failed() == true), устанавливает ios::badbit.

Оригинал:

Inserts bool value by calling num_put::put() If the end of file condition was encountered during output (put().failed() == true), sets ios::badbit.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

7)

Вставляет общее значение указателя по телефону num_put::put() Если конец файла условием была обнаружена во время выхода (put().failed() == true), устанавливает ios::badbit.

Оригинал:

Inserts a generic pointer value by calling num_put::put() If the end of file condition was encountered during output (put().failed() == true), sets ios::badbit.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

8)

Вставки все данные из sb. После построения часового объект, проверяет sb является нулевым указателем. Если это так, выполняет setstate(badbit) и выходы. В противном случае, извлекает символы из входной последовательности контролируется sb и вставляет их в *this до одного из следующих условий:

Оригинал:

Inserts all data from sb. After constructing the sentry object, checks if sb is a null pointer. If it is, executes setstate(badbit) and exits. Otherwise, extracts characters from the input sequence controlled by sb and inserts them into *this until one of the following conditions are met:

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• конец файла происходит на входной последовательности;

  Оригинал:

  end-of-file occurs on the input sequence;

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• вставка в выходной последовательности не удается (в этом случае символ, который будет вставлен не извлекается);

  Оригинал:

  inserting in the output sequence fails (in which case the character to be inserted is not extracted);

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• происходит исключение (в этом случае исключение перехватывается).

  Оригинал:

  an exception occurs (in which case the exception is caught).

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Если символы не были добавлены, выполняет setstate(badbit). Если исключение при добыче, устанавливает failbit

Оригинал:

If no characters were inserted, executes setstate(badbit). If an exception was thrown while extracting, sets failbit

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

9)

Звонки func(*this);. Эта перегрузка используется для реализации выхода I / O манипуляторы, такие как std::endl.

Оригинал:

Calls func(*this);. This overload is used to implement output I/O manipulators such as std::endl.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Параметры

value	—	целое, с плавающей точкой, логические, или значение указателя для вставки Оригинал: integer, floating-point, boolean, or pointer value to insert Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
func	—	функции для вызова Оригинал: function to call Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
sb	—	указатель на streambuffer читать данные Оригинал: pointer to the streambuffer to read the data from Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

*this

Заметки

Есть нет перегрузки для указателей на летучих или указателей на функции (кроме тех, с подписями принято 9) перегрузки). Попытка вывода таких объектов вызывает неявное преобразование в bool, и для любой ненулевой указатель, значение 1 печатается (если boolalpha был установлен).

Оригинал:

There are no overload for pointers to volatile or function pointers (other than the ones with signatures accepted by the 9) overload). Attempting to output such objects invokes implicit conversion to bool, and, for any non-null pointer value, the value 1 is printed (unless boolalpha was set).

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Пример

Запустить этот код

#include <iostream>
#include <iomanip>
#include <sstream>
int main()
{
    std::istringstream input(" \"Some text.\" ");
    volatile int n = 42;
    double f = 3.14;
    bool b = true;;
    std::cout << n   // int overload
              << ' ' // non-member overload
              << std::boolalpha << b // bool overload
              << " " // non-member overload
              << std::fixed << f // double overload
              << input.rdbuf() // streambuf overload
              << &n // bool overload
              << std::endl; // function overload
}

Вывод:

42 true 3.140000 "Some text." true

См. также

operator<<(std::basic_ostream)	вставляет символьные данные в поток вывода std::basic_ostream (функция)
operator<<operator>>	выполняет поток ввода / вывода строк Оригинал: performs stream I/O of strings Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (шаблон функции)
operator<<operator>>	выполняет входной поток и выход bitsets Оригинал: performs stream input and output of bitsets Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (функция)
operator<<operator>>	сериализации и десериализации комплексного числа Оригинал: serializes and deserializes a complex number Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (шаблон функции)
operator<<operator>>	выполняют потоковый вывод/ввод для объекта генератора псевдослучайных чисел (функция)
operator<<operator>>	выполняют потоковый вывод/ввод для объекта распределения псевдослучайных чисел (функция)
put	вставляет символ Оригинал: inserts a character Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
write	вставляет блок символов (public функция-элемент)