std::basic_streambuf<CharT,Traits>::sputn, std::basic_streambuf<CharT,Traits>::xsputn
提供: cppreference.com
< cpp | io | basic streambuf
| std::streamsize sputn( const char_type* s, std::streamsize count ); |
(1) | |
| protected: virtual std::streamsize xsputn( const char_type* s, std::streamsize count ); |
(2) | |
1) 最も派生したクラスの
xsputn(s, count) を呼びます。2)
s によって最初の要素が指される文字配列から出力シーケンスに count 個の文字を書き込みます。 文字は sputc() を繰り返し呼んだかのように書き込まれます。 書き込みは count 個の文字が書き込まれるか、 sputc() の呼び出しが Traits::eof() を返すときに停止します。put 領域がいっぱい (pptr() == epptr()) になった場合、この関数は overflow() を呼ぶか、または他の何らかの未規定な方法によって overflow() の効果を達成するかもしれません。
目次 |
[編集] 引数
(なし)
[編集] 戻り値
書き込みに成功した文字数。
[編集] ノート
「未規定な方法によって overflow() の効果を達成する」は中間バッファリングなしのバルク I/O を許容します。 これにより入出力ストリームのいくつかの実装では std::ofstream::write が単純に POSIX の write() システムコールにポインタを渡すことができます。
[編集] 例
Run this code
#include <iostream> #include <sstream> int main() { std::ostringstream s1; std::streamsize sz = s1.rdbuf()->sputn("This is a test", 14); s1 << '\n'; std::cout << "The call to sputn() returned " << sz << '\n' << "The output sequence contains " << s1.str(); std::istringstream s2; sz = s2.rdbuf()->sputn("This is a test", 14); std::cout << "The call to sputn() on an input stream returned " << sz << '\n'; }
出力:
The call to sputn() returned 14 The output sequence contains This is a test The call to sputn() on an input stream returned 0
[編集] 関連項目
| xsgetn() を呼びます (パブリックメンバ関数) |
