GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::basic_stringstream::コンストラクタ - cpprefjp C++日本語リファレンス

最終更新日時: 2026年08月25日 12時11分17秒 (JST)
Akira Takahashi が更新

function

std::basic_stringstream::コンストラクタ

basic_stringstream()
  : basic_stringstream(ios_base::in | ios_base::out) {}     // (1) C++11
explicit basic_stringstream(
  ios_base::openmode which);                                // (2) C++11
explicit basic_stringstream(
  ios_base::openmode which = ios_base::in | ios_base::out); // (1)+(2) C++98

explicit basic_stringstream(
  const basic_string<CharT, Traits, Allocator>& s,
  ios_base::openmode which = ios_base::in | ios_base::out); // (3) C++98

explicit basic_stringstream(
  basic_string<CharT, Traits, Allocator>&& s,
  ios_base::openmode which = ios_base::in | ios_base::out);       // (4) C++20

basic_stringstream(ios_base::openmode which, const Allocator& a); // (5) C++20

explicit basic_stringstream(
  const basic_string<CharT, Traits, Allocator>& s,
  const Allocator& a)
    : basic_stringstream(s, ios_base::in | ios_base::out, a) {}   // (6) C++20

explicit basic_stringstream(
  const basic_string<CharT, Traits, Allocator>& s,
  ios_base::openmode which,
  const Allocator& a);                                            // (7) C++20

template<class SAlloc>
explicit basic_stringstream(
  const basic_string<CharT, Traits, SAlloc>& s,
  ios_base::openmode which = ios_base::in | ios_base::out);       // (8) C++20

template<class SAlloc>
basic_stringstream(
  const basic_string<CharT, Traits, SAlloc>& s,
  const Allocator& a)
    : basic_stringstream(s, ios_base::in | ios_base::out, a) {}   // (9) C++20

template<class SAlloc>
basic_stringstream(
  const basic_string<CharT, Traits, SAlloc>& s,
  ios_base::openmode which,
  const Allocator& a);                                            // (10) C++20

basic_stringstream(basic_stringstream&& rhs);                     // (11) C++11

template<class T>
explicit basic_stringstream(
  const T& t,
  ios_base::openmode which = ios_base::in | ios_base::out);       // (12) C++26

template<class T>
basic_stringstream(
  const T& t,
  const Allocator& a);                                            // (13) C++26

template<class T>
basic_stringstream(const T& t,
  ios_base::openmode which,
  const Allocator& a);                                            // (14) C++26

概要

basic_stringstreamオブジェクトを構築する。

ここで、初期値として設定する文字列は、既存のファイルを上書きモードで開くことに似ており、ストリームの初期位置が先頭のまま、ストリーム内容の文字列を設定するものである。

(1) : デフォルトコンストラクタ
(2) : 指定されたモードで構築する
(3) : 初期文字列としてstd::basic_stringオブジェクトのコピーを指定して構築する
(4) : 初期文字列としてstd::basic_stringオブジェクトの右辺値参照を指定して構築する
(5) : 指定されたモードとアロケータで構築する
(6) : 初期文字列としてstd::basic_stringオブジェクトのコピーと、アロケータを指定して構築する
(7) : 初期文字列としてstd::basic_stringオブジェクトのコピー、モード、アロケータを指定して構築する
(8) : 初期文字列としてAllocatorに変換可能なアロケータをもつstd::basic_stringオブジェクトのコピーと、モードを指定して構築する
(9) : 初期文字列としてAllocatorに変換可能なアロケータをもつstd::basic_stringオブジェクトのコピーと、アロケータを指定して構築する
(10) : 初期文字列としてAllocatorに変換可能なアロケータをもつstd::basic_stringオブジェクトのコピー、モード、アロケータを指定して構築する
(11) : ムーブコンストラクタ
(12) : 初期文字列としてstd::basic_string_viewに変換可能な文字列と、モードを指定して構築する
(13) : 初期文字列としてstd::basic_string_viewに変換可能な文字列と、アロケータを指定して構築する
(14) : 初期文字列としてstd::basic_string_viewに変換可能な文字列、モード、アロケータを指定して構築する

テンプレートパラメータ制約

(12), (13), (14) : is_convertible_v<const T&, basic_string_view<CharT, Traits>>がtrueであること

効果

(1) : 内部のbasic_stringbufオブジェクトをbasic_stringbuf<CharT, Traits, Allocator>(ios_base::in | ios_base::out)で構築する
(2) : 内部のbasic_stringbufオブジェクトをbasic_stringbuf<CharT, Traits, Allocator>(which)で構築する
(3) : 内部のbasic_stringbufオブジェクトをbasic_stringbuf<CharT, Traits, Allocator>(s, which)で構築する
(4) : 内部のbasic_stringbufオブジェクトをbasic_stringbuf<CharT, Traits, Allocator>(std::move(s), which)で構築する
(5) : 内部のbasic_stringbufオブジェクトをbasic_stringbuf<CharT, Traits, Allocator>(which, a)で構築する
(6), (7), (8), (9), (10) : 各引数は対応するbasic_stringbufのコンストラクタに渡される
(11) : rhsからbasic_stringstreamオブジェクトをムーブ構築する
(12) : basic_string_view<CharT, Traits>(t)で文字列を初期化し、モードはwhichに設定する
(13) : basic_string_view<CharT, Traits>(t)で文字列を初期化し、モードはios_base::in | ios_base::out、アロケータはaに設定する
(14) : basic_string_view<CharT, Traits>(t)で文字列を初期化し、モードはwhich、アロケータはaに設定する

例

基本的な使い方

#include <iostream>
#include <sstream>
#include <string>

int main()
{
  // (1) デフォルト構築
  std::stringstream ss1;
  ss1 << "hello";
  std::string s;
  ss1 >> s;
  std::cout << s << std::endl;

  // (3) 文字列を指定して構築
  std::stringstream ss2("initial value", std::ios_base::out | std::ios_base::app);
  ss2 << " added";
  std::cout << ss2.str() << std::endl;
}

出力

hello
initial value added

string_viewからの構築 (C++26)

#include <iostream>
#include <sstream>
#include <string_view>

int main()
{
  // 文字列リテラルから構築
  std::stringstream ss1{"Hello?"};
  ss1.seekp(0, std::ios_base::end); // 書き込み位置を末尾に設定
  ss1 << "World";
  std::cout << ss1.str() << std::endl;

  // string_viewから構築
  std::string_view sv = "Hello?";
  std::stringstream ss2{sv};
  ss2 << "World";
  std::cout << ss2.str() << std::endl;
}

出力

Hello?World
World?

参照

P0408R7 Efficient Access to basic_stringbuf's Buffer
P2495R3 Interfacing stringstreams with string_view
- C++26でstd::string_viewに対応した

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.