名前空間
変種

    std::basic_streambuf<CharT,Traits>::sputn, std::basic_streambuf<CharT,Traits>::xsputn

    提供: cppreference.com
     
    C++
     
    入出力ライブラリ
    入出力マニピュレータ
    Cスタイルの入出力
    バッファ
    (C++98で非推奨)
    (C++20)
    ストリーム
    抽象
    ファイル入出力
    文字列入出力
    配列入出力
    (C++98で非推奨)
    (C++98で非推奨)
    (C++98で非推奨)
    同期化出力
    (C++20)
    型
    エラーカテゴリインタフェース
    (C++11)
    (C++11)
     
    std::basic_streambuf
    パブリックメンバ関数
    ロケール
    位置設定
    get 領域
    put 領域
    putback
    プロテクテッドメンバ関数
    (C++11)
    (C++11)
    ロケール
    位置設定
    get 領域
    put 領域
    putback
     
    <tbody> </tbody>
    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() を呼びます
    (パブリックメンバ関数) [edit]