最終更新日時: 2025年07月10日 09時58分01秒 (JST)
Koichi Murase が更新

履歴 編集

function
<streambuf>

# std::basic_streambuf::sputn

    namespace std {
      template<class CharT, class Traits = char_traits<CharT>>
      class basic_streambuf {
      public:
        std::streamsize sputn(const char_type* s, std::streamsize n);

        ……
      };
    }

## 概要

出力列に複数文字を書き込む。

## 効果

`xsputn(s, n)`を呼ぶ。`xsputn()`はprotected virtualなので、継承されていれば、継承先の`xsputn()`が呼ばれる。

## 戻り値

`xsputn(s, n)`の戻り値。

## 例

    #include <iostream>
    #include <streambuf>

    // streambufを継承したクラス
    class dummy_buf : public std::streambuf {
    public:
        dummy_buf(char* begin, char* end) {
            // 出力列の領域を指定
            setp(begin, end);
        }
    };

    int main() {
        char space[10] = {};
        dummy_buf buf{space, space + 10};
        std::cout << buf.sputn("ABCDE", 3) << std::endl;  // 3文字書き込む
        std::cout << space << std::endl;  // 書き込んだ文字列を出力
    }

### 出力

    3
    ABC

## バージョン

### 言語

- C++98

## 参照

- `xsputn()`