ostreambuf_iterator Sınıfı

Sınıf şablonu ostreambuf_iterator, ayıklama işleciyle>> çıkış akışına ardışık karakter öğeleri yazan bir çıkış yineleyici nesnesi açıklar. s ostreambuf_iterator, çıkış akışına eklenen nesnenin türünde genel bir tür yerine karakterlere sahip ostream_iterator Sınıfı'ndan farklıdır.

Sözdizimi

template <class CharType = char class Traits = char_traits <CharType>>

Parametreler

CharType
ostreambuf_iterator için karakter türünü temsil eden tür. Bu bağımsız değişken isteğe bağlıdır ve varsayılan değerdir char.

Özellik
ostreambuf_iterator için karakter türünü temsil eden tür. Bu bağımsız değişken isteğe bağlıdır ve varsayılan değer CharType'tırchar_traits<>.

Açıklamalar

Ostreambuf_iterator sınıfının, bir çıkış yineleyici için gereksinimleri karşılaması gerekir. Algoritmalar bir kullanılarak ostreambuf_iteratorçıkış akışlarına doğrudan yazılabilir. Sınıf, karakterlerin biçimindeki ham (biçimlendirilmemiş) G/Ç akışına erişim sağlayarak düşük düzey bir akış ve üst düzey akış yineleyicilerle ilişkili arabelleğe alma işlemini ve karakter çevirilerini atlama özelliği sağlar.

Oluşturucular

Tür tanımları

Üye işlevleri

İşleçler

Gereksinimler

Üst bilgi:<yineleyici>

Ad alanı: std

ostreambuf_iterator::char_type

öğesinin karakter türünü sağlayan bir tür ostreambuf_iterator.

typedef CharType char_type;

Açıklamalar

türü, şablon parametresi CharTypeiçin bir eş anlamlıdır.

Örnek

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

int main( )
{
   using namespace std;

   typedef ostreambuf_iterator<char>::char_type CHT1;
   typedef ostreambuf_iterator<char>::traits_type CHTR1;

   // ostreambuf_iterator for stream cout
   // with new line delimiter:
    ostreambuf_iterator< CHT1, CHTR1> charOutBuf ( cout );

   // Standard iterator interface for writing
   // elements to the output streambuf:
   cout << "The characters written to the output stream\n"
        << " by charOutBuf are: ";
*charOutBuf = 'O';
   charOutBuf++;
*charOutBuf = 'U';
   charOutBuf++;
*charOutBuf = 'T';
   charOutBuf++;
   cout << "." << endl;
}
/* Output:
The characters written to the output stream
by charOutBuf are: OUT.
*/

ostreambuf_iterator::failed

Çıkış akışı arabelleğine ekleme hatasını sınar.

bool failed() const throw();

Dönüş Değeri

true çıkış akışı arabelleğine daha önce ekleme başarısız olduysa; aksi takdirde false.

Açıklamalar

Üye işlevi, üyenin önceki kullanımlarında subf_-sputc> çağrısının döndürdüğü eof değerini döndürürtrue.operator=

Örnek

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

int main( )
{
   using namespace std;

   // ostreambuf_iterator for stream cout
   ostreambuf_iterator<char> charOut ( cout );

*charOut = 'a';
   charOut ++;
*charOut  = 'b';
   charOut ++;
*charOut = 'c';
   cout << " are characters output individually." << endl;

   bool b1 = charOut.failed ( );
   if (b1)
       cout << "At least one insertion failed." << endl;
   else
       cout << "No insertions failed." << endl;
}
/* Output:
abc are characters output individually.
No insertions failed.
*/

ostreambuf_iterator::operator*

Çıkış yineleyici ifadesini * i = x uygulamak için kullanılan işlev dışı başvuru kaldırma işleci.

ostreambuf_iterator<CharType, Traits>& operator*();

Dönüş Değeri

ostreambuf yineleyici nesnesi.

Açıklamalar

Bu işleç yalnızca çıkış yineleyici ifadesinde * i = x çıkış karakterlerini akış arabelleğine dönüştürür. Bir ostreambuf yineleyicisine uygulandığında yineleyiciyi döndürür; *yineleyici yineleyici döndürür,

Örnek

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

int main( )
{
   using namespace std;

   // ostreambuf_iterator for stream cout
   // with new line delimiter
   ostreambuf_iterator<char> charOutBuf ( cout );

   // Standard iterator interface for writing
   // elements to the output stream
   cout << "Elements written to output stream:" << endl;
*charOutBuf = 'O';
   charOutBuf++;   // no effect on iterator position
*charOutBuf = 'U';
*charOutBuf = 'T';
}
/* Output:
Elements written to output stream:
OUT
*/

ostreambuf_iterator::operator++

İşlem çağrılmadan önce ele alınan karaktere bir akış yineleyicisi döndüren işlevsiz bir artış işleci.

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

Dönüş Değeri

Başlangıçta ele alınan karaktere veya CharType, Traits'e> dönüştürülebilen uygulama tanımlı bir nesneye<ostreambuf_iterator başvuru.

Açıklamalar

işleci, çıkış yineleyici ifadesini * i = x uygulamak için kullanılır.

Örnek

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

int main( )
{
   using namespace std;

   // ostreambuf_iterator for stream cout
   // with new line delimiter
   ostreambuf_iterator<char> charOutBuf ( cout );

   // Standard iterator interface for writing
   // elements to the output stream
   cout << "Elements written to output stream:" << endl;
*charOutBuf = 'O';
   charOutBuf++;      // No effect on iterator position
*charOutBuf = 'U';
*charOutBuf = 'T';
}
/* Output:
Elements written to output stream:
OUT
*/

ostreambuf_iterator::operator=

İşleç, ilişkili akış ara belleğine bir karakter ekler.

ostreambuf_iterator<CharType, Traits>& operator=(CharType _Char);

Parametreler

_Char
Akış arabelleğine eklenecek karakter.

Dönüş Değeri

Akış arabelleğine eklenen karaktere başvuru.

Açıklamalar

Çıkış yineleyicisi ifadesini * bir çıkış akışına yazmak için i = x uygulamak için kullanılan atama işleci.

Örnek

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

int main( )
{
   using namespace std;

   // ostreambuf_iterator for stream cout
   // with new line delimiter
   ostreambuf_iterator<char> charOutBuf ( cout );

   // Standard iterator interface for writing
   // elements to the output stream
   cout << "Elements written to output stream:" << endl;
*charOutBuf = 'O';
   charOutBuf++;      // No effect on iterator position
*charOutBuf = 'U';
*charOutBuf = 'T';
}
/* Output:
Elements written to output stream:
OUT
*/

ostreambuf_iterator::ostreambuf_iterator

Çıkış akışına karakter yazmak için başlatılan bir ostreambuf_iterator oluşturur.

ostreambuf_iterator(streambuf_type* strbuf) throw();
ostreambuf_iterator(ostream_type& Ostr) throw();

Parametreler

strbuf
Çıkış stream-buffer işaretçisini başlatmak için kullanılan çıkış streambuf nesnesi.

Ostr
Çıkış stream-buffer işaretçisini başlatmak için kullanılan çıkış akışı nesnesi.

Açıklamalar

İlk oluşturucu, çıkış stream-buffer işaretçisini strbuf ile başlatır.

İkinci oluşturucu ile çıkış stream-buffer işaretçisini Ostrbaşlatır. rdbuf. Depolanan işaretçi null bir işaretçi olmamalıdır.

Örnek

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

int main( )
{
   using namespace std;

   // ostreambuf_iterator for stream cout
   ostreambuf_iterator<char> charOut ( cout );

*charOut = 'O';
   charOut ++;
*charOut  = 'U';
   charOut ++;
*charOut = 'T';
   cout << " are characters output individually." << endl;

   ostreambuf_iterator<char> strOut ( cout );
   string str = "These characters are being written to the output stream.\n ";
   copy ( str.begin ( ), str. end ( ), strOut );
}
/* Output:
OUT are characters output individually.
These characters are being written to the output stream.
*/

ostreambuf_iterator::ostream_type

akış türü için sağlayan bir tür ostream_iterator.

typedef basicOstream<CharType, Traits> ostream_type;

Açıklamalar

Türü CharType, Traits için basicOstream<bir eş anlamlıdır>

Örnek

bildirme ve kullanma ostream_typeörneği için bkz. ostreambuf_iterator.

ostreambuf_iterator::streambuf_type

akış türü için sağlayan bir tür ostreambuf_iterator.

typedef basic_streambuf<CharType, Traits> streambuf_type;

Açıklamalar

türü, karakter türüne basic_streambuf<özel olduğunda olan streambuf G/Ç arabellekleri için bir akış sınıfı olan CharType, Traits> için bir eş anlamlıdır.char

Örnek

bildirme ve kullanma streambuf_typeörneği için bkz. ostreambuf_iterator.

ostreambuf_iterator::traits_type

karakterinin karakter özellikleri türünü sağlayan bir ostream_iteratortür.

typedef Traits traits_type;

Açıklamalar

türü, şablon parametresi Traitsiçin bir eş anlamlıdır.

Örnek

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

int main( )
{
   using namespace std;

   typedef ostreambuf_iterator<char>::char_type CHT1;
   typedef ostreambuf_iterator<char>::traits_type CHTR1;

   // ostreambuf_iterator for stream cout
   // with new line delimiter:
    ostreambuf_iterator< CHT1, CHTR1> charOutBuf ( cout );

   // Standard iterator interface for writing
   // elements to the output streambuf:
   cout << "The characters written to the output stream\n"
        << " by charOutBuf are: ";
*charOutBuf = 'O';
   charOutBuf++;
*charOutBuf = 'U';
   charOutBuf++;
*charOutBuf = 'T';
   charOutBuf++;
   cout << "." << endl;
}
/* Output:
The characters written to the output stream
by charOutBuf are: OUT.
*/

Ayrıca bkz.

<Yineleyici>
C++ Standart Kitaplığında İş Parçacığı Güvenliği
C++ Standart Kitaplığı Başvurusu