std::basic_stringbuf<CharT,Traits,Allocator>::swap

 

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_stringbuf

公開成員函式

basic_stringbuf::basic_stringbuf

basic_stringbuf::operator= (C++11)

basic_stringbuf::swap (C++11)

basic_stringbuf::str

basic_stringbuf::get_allocator (C++20)

basic_stringbuf::view (C++20)

受保護的成員函式

basic_stringbuf::underflow

basic_stringbuf::pbackfail

basic_stringbuf::overflow

basic_stringbuf::setbuf

basic_stringbuf::seekoff

basic_stringbuf::seekpos

非成員函式

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

僅用於說明的成員函式

basic_stringbuf::init_buf_ptrs

 

void swap( basic_stringbuf& rhs );		(C++11 起) (C++20 前)
void swap( basic_stringbuf& rhs ) noexcept(/* 見下方 */);		(C++20 起)

交換 *this 和 rhs 的狀態和內容。

若 Allocator 不在交換時傳播，且 *this 和 other 的分配器不相等，則行為未定義。

(C++11 起)

引數

rhs

-

- 另一個 basic_stringbuf

返回值

(無)

異常

可能丟擲實現定義的異常。	(C++11 起) (C++20 前)
noexcept 規範：   noexcept(std::allocator_traits<Allocator>::propagate_on_container_swap::value || std::allocator_traits<Allocator>::is_always_equal::value)	(C++20 起)

注意

當交換 std::stringstream 物件時，會自動呼叫此函式。很少需要直接呼叫它。

示例

執行此程式碼

#include <iomanip>
#include <iostream>
#include <sstream>
#include <string>
 
int main()
{
    std::istringstream one("one");
    std::ostringstream two("two");
 
    std::cout << "Before swap: one = " << std::quoted(one.str())
              << ", two = " << std::quoted(two.str()) << ".\n";
 
    one.rdbuf()->swap(*two.rdbuf());
 
    std::cout << "After  swap: one = " << std::quoted(one.str())
              << ", two = " << std::quoted(two.str()) << ".\n";
}

輸出

Before swap: one = "one", two = "two".
After  swap: one = "two", two = "one".

參閱

(建構函式)	構造 basic_stringbuf 物件 (公開成員函式)
swap (C++11)	交換兩個字串流 (std::basic_stringstream<CharT,Traits,Allocator> 的公開成員函式)