Поделиться через

Класс ostream_iterator

Шаблон класса ostream_iterator описывает объект итератора вывода, который записывает последовательные элементы в выходной поток с извлечением .

Синтаксис

template <class Type, class CharType = char, class Traits = char_traits <CharType>>
class ostream_iterator

Параметры

Type
Тип объекта, который необходимо вставить в поток вывода.

CharType
Тип, представляющий шрифт символа для . Этот аргумент является необязательным, и значением по умолчанию является .

Traits
Тип, представляющий шрифт символа для . Этот аргумент является необязательным, а значение по умолчанию — .*

Класс ostream_iterator должен удовлетворять требованиям для итератора вывода. Алгоритмы можно записывать непосредственно в потоки вывода с помощью .

Конструкторы

Конструктор Description
ostream_iterator Создает , инициализированный и разделенный для записи в поток вывода.

Определения типов

Введите имя Description
char_type Тип, обеспечивающий тип символа для .
ostream_type Тип, обеспечивающий тип потока для .
traits_type Тип, обеспечивающий тип признаков символа для .

Операторы

Operator Description
operator* Оператор dereferencing, используемый для реализации выражения выходного итератора.
operator++ Нефункциональный оператор инкремента, возвращающий , обращающийся к тому же объекту, к которому он обращался до вызова операции.
operator= Оператор назначения, используемый для реализации выражения выходного итератора для записи в выходной поток.

Требования

Заголовок:

Пространство имен:

ostream_iterator::char_type

Тип, обеспечивающий тип символа для итератора.

typedef CharType char_type;

Замечания

Этот тип является синонимом для параметра шаблона .

Пример

// ostream_iterator_char_type.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   typedef ostream_iterator<int>::char_type CHT1;
   typedef ostream_iterator<int>::traits_type CHTR1;

   // ostream_iterator for stream cout
   // with new line delimiter:
    ostream_iterator<int, CHT1, CHTR1> intOut ( cout , "\n" );

   // Standard iterator interface for writing
   // elements to the output stream:
   cout << "The integers written to the output stream\n"
        << "by intOut are:" << endl;
*intOut = 10;
*intOut = 20;
*intOut = 30;
}

The integers written to the output stream
by intOut are:
10
20
30

ostream_iterator::operator*

Оператор dereferencing, используемый для реализации выражения выходного итератора.

ostream_iterator<Type, CharType, Traits>& operator*();

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

Ссылка на .

Замечания

Требования к выходному итератору, необходимые для удовлетворения, требуют только допустимого выражения и ничего не говорит о собственном или собственном. Оператор-член в этой реализации возвращается .

Пример

// ostream_iterator_op_deref.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // ostream_iterator for stream cout
   // with new line delimiter
   ostream_iterator<int> intOut ( cout , "\n" );

   // Standard iterator interface for writing
   // elements to the output stream
   cout << "Elements written to output stream:" << endl;
   *intOut = 10;
   intOut++;      // No effect on iterator position
   *intOut = 20;
   *intOut = 30;
}

Elements written to output stream:
10
20
30

ostream_iterator::operator++

Нефункциональный оператор инкремента, возвращающий , обращающийся к тому же объекту, к которому он обращался до вызова операции.

ostream_iterator<Type, CharType, Traits>& operator++();
ostream_iterator<Type, CharType, Traits> operator++(int);

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

Ссылка на .

Замечания

Эти операторы-члены возвращаются .

Пример

// ostream_iterator_op_incr.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // ostream_iterator for stream cout
   // with new line delimiter
   ostream_iterator<int> intOut ( cout , "\n" );

   // standard iterator interface for writing
   // elements to the output stream
   cout << "Elements written to output stream:" << endl;
   *intOut = 10;
   intOut++;      // No effect on iterator position
   *intOut = 20;
   *intOut = 30;
}

Elements written to output stream:
10
20
30

ostream_iterator::operator=

Оператор назначения, используемый для реализации выражения output_iterator для записи в выходной поток.

ostream_iterator<Type, CharType, Traits>& operator=(const Type& val);

Параметры

val
Значение объекта типа , который нужно вставить в поток вывода.

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

Оператор вставляется в выходной поток, связанный с объектом, за которым следует разделитель, указанный в (если есть), а затем возвращает ссылку на объект.

Замечания

Требования к выходному итератору, которые должны удовлетворять, требуют только допустимого выражения и ничего не говорит о операторе или операторе= самостоятельно. Этот оператор-член возвращает .

Пример

// ostream_iterator_op_assign.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // ostream_iterator for stream cout
   // with new line delimiter
   ostream_iterator<int> intOut ( cout , "\n" );

   // Standard iterator interface for writing
   // elements to the output stream
   cout << "Elements written to output stream:" << endl;
   *intOut = 10;
   intOut++;      // No effect on iterator position
   *intOut = 20;
   *intOut = 30;
}

Elements written to output stream:
10
20
30

ostream_iterator::ostream_iterator

Создает , инициализированный и разделенный для записи в поток вывода.

ostream_iterator(ostream_type& _Ostr);

ostream_iterator(
    ostream_type& _Ostr,
    const CharType* _Delimiter);

Параметры

_Ostr
Выходной поток типа для итерации.

_Delimiter
Разделитель, который вставляется в поток вывода между значениями.

Замечания

Первый конструктор инициализирует указатель потока вывода значением . Указатель на строку разделителя обозначает пустую строку.

Второй конструктор инициализирует указатель выходного потока с указателем строки разделителя.

Пример

// ostream_iterator_ostream_iterator.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // ostream_iterator for stream cout
   ostream_iterator<int> intOut ( cout , "\n" );
   *intOut = 10;
   intOut++;
   *intOut = 20;
   intOut++;

   int i;
   vector<int> vec;
   for ( i = 1 ; i < 7 ; ++i )
   {
      vec.push_back (  i );
   }

   // Write elements to standard output stream
   cout << "Elements output without delimiter: ";
   copy ( vec.begin ( ), vec.end ( ),
          ostream_iterator<int> ( cout ) );
   cout << endl;

   // Write elements with delimiter " : " to output stream
   cout << "Elements output with delimiter: ";
   copy ( vec.begin ( ), vec.end ( ),
          ostream_iterator<int> ( cout, " : " ) );
   cout << endl;
}

10
20
Elements output without delimiter: 123456
Elements output with delimiter: 1 : 2 : 3 : 4 : 5 : 6 :

ostream_iterator::ostream_type

Тип, обеспечивающий тип потока для итератора.

typedef basic_ostream<CharType, Traits> ostream_type;

Замечания

Тип является синонимом для класса потока иерархии iostream, который определяет объекты, которые можно использовать для записи.

Пример

Пример объявления и использования .

ostream_iterator::traits_type

Тип, обеспечивающий тип признаков символа итератора.

typedef Traits traits_type;

Замечания

Этот тип является синонимом для параметра шаблона .

Пример

// ostream_iterator_traits_type.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // The following not OK, but are just the default values:
   typedef ostream_iterator<int>::char_type CHT1;
   typedef ostream_iterator<int>::traits_type CHTR1;

   // ostream_iterator for stream cout
   // with new line delimiter:
    ostream_iterator<int, CHT1, CHTR1> intOut ( cout , "\n" );

   // Standard iterator interface for writing
   // elements to the output stream:
   cout << "The integers written to output stream\n"
        << "by intOut are:" << endl;
*intOut = 1;
*intOut = 10;
*intOut = 100;
}

The integers written to output stream
by intOut are:
1
10
100

См. также

<iterator>
Потокобезопасность в стандартной библиотеке C++
Справочник по стандартной библиотеке C++

  • Last updated on