std::basic_stringstream<CharT,Traits,Allocator>::str

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

檔案 I/O

basic_ifstream

basic_ofstream

basic_fstream

字串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

陣列 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

basic_osyncstream (C++20)

型別

streamoff

streamsize

fpos

錯誤類別介面

iostream_category (C++11)

io_errc (C++11)

 

std::basic_stringstream

成員函式

basic_stringstream::basic_stringstream

basic_stringstream::operator=

basic_stringstream::swap (C++11)

basic_stringstream::rdbuf

字串操作

basic_stringstream::str

basic_stringstream::view (C++20)

非成員函式

swap(std::basic_stringstream) (C++11)

 

	(1)
std::basic_string<CharT, Traits, Allocator> str() const;			(C++20 前)
std::basic_string<CharT, Traits, Allocator> str() const&;			(C++20 起)
template< class SAlloc > std::basic_string<CharT, Traits, SAlloc> str( const SAlloc& a ) const;		(2)	(C++20 起)
std::basic_string<CharT, Traits, Allocator> str() &&;		(3)	(C++20 起)
void str( const std::basic_string<CharT, Traits, Allocator>& s );		(4)
template< class SAlloc > void str( const std::basic_string<CharT, Traits, SAlloc>& s );		(5)	(C++20 起)
void str( std::basic_string<CharT, Traits, Allocator>&& s );		(6)	(C++20 起)
template< class StringViewLike > void str( const StringViewLike& t );		(7)	(C++26 起)

管理底層字串物件的內容。

1) 返回底層字串的副本。等價於 return rdbuf()->str();。

2) 返回底層字串的副本，使用 a 作為分配器。等價於 return rdbuf()->str(a);。

3) 返回一個從底層字串移動構造的字串。等價於 return std::move(*rdbuf()).str();。

4,5) 替換底層字串的內容。等價於 rdbuf()->str(s);。

6) 替換底層字串的內容。等價於 rdbuf()->str(std::move(s));。

7) 替換底層字串的內容。等價於 rdbuf()->str(t);。

此過載僅當 is_convertible_v<const T&, basic_string_view<charT, traits>> 為 true 時才參與過載決議。

引數

s	-	底層字串的新內容
t	-	用作底層字串新內容的（可轉換為 std::basic_string_view 的）物件
a	-	用於構造返回字串的分配器

返回值

1,2) 底層字串物件的副本。

3) 從底層字串物件移動構造的字串。

4-7) (無)

注意

str 返回的底層字串的副本是一個臨時物件，它將在表示式結束時被銷燬，因此直接在 str() 的結果上呼叫 c_str()（例如在 auto *ptr = out.str().c_str(); 中）會導致懸空指標。

特性測試宏	值	標準	特性
__cpp_lib_sstream_from_string_view	202306L	(C++26)	將 std::stringstream 與 std::string_view 連線，(7)

示例

執行此程式碼

#include <iostream>
#include <sstream>
 
int main()
{
    int n;
 
    std::istringstream in; // could also use in("1 2")
    in.str("1 2");
    in >> n;
    std::cout << "After reading the first int from \"1 2\", the int is "
              << n << ", str() = \"" << in.str() << "\"\n";
 
    std::ostringstream out("1 2");
    out << 3;
    std::cout << "After writing the int '3' to output stream \"1 2\""
              << ", str() = \"" << out.str() << "\"\n";
 
    std::ostringstream ate("1 2", std::ios_base::ate);
    ate << 3;
    std::cout << "After writing the int '3' to append stream \"1 2\""
              << ", str() = \"" << ate.str() << "\"\n";
}

輸出

After reading the first int from "1 2", the int is 1, str() = "1 2"
After writing the int '3' to output stream "1 2", str() = "3 2"
After writing the int '3' to append stream "1 2", str() = "1 23"

參閱

rdbuf	返回底層原始字串裝置物件 (public member function)
str	替換或獲取關聯字元字串的副本 (public member function of std::basic_stringbuf<CharT,Traits,Allocator>)