operator<<,>>(std::basic_string)

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

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

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

字串庫

類

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

成員函式 basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator 元素訪問 basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) 迭代器 basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) 搜尋 basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of

修改器 basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap 容量 basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) 操作 basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

常量 basic_string::npos 非成員函式 operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline 比較 operator==operator!=operator<operator>operator<=operator>=operator<=> (until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20) 數值轉換 stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) 字面量 operator""s (C++14) 輔助類 hash<std::basic_string> (C++11) 推導指南 (C++17)

 

定義於標頭檔案 <string>
template< class CharT, class Traits, class Allocator > std::basic_ostream<CharT, Traits>&     operator<<( std::basic_ostream<CharT, Traits>& os,                 const std::basic_string<CharT, Traits, Allocator>& str );	(1)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     operator>>( std::basic_istream<CharT, Traits>& is,                 std::basic_string<CharT, Traits, Allocator>& str );	(2)

1) 行為如同一個 FormattedOutputFunction。在構造並檢查哨兵物件後，確定輸出格式填充。

然後將結果序列 seq（str 的內容加填充）中的每個字元插入到輸出流 os，如同呼叫 os.rdbuf()->sputn(seq, n)，其中 n 是 std::max(os.width(), str.size())。最後，呼叫 os.width(0) 以取消 std::setw（如果有）的效果。

等價於 return os << std::basic_string_view<CharT, Traits>(str);。

(C++17 起)

2) 行為如同一個 FormattedInputFunction。在構造並檢查哨兵物件（其可能跳過前導空白字元）後，首先用 str.erase() 清空 str，然後從 is 讀取字元並將其附加到 str，如同透過 str.append(1, c)，直到以下條件之一變為真：

• 讀取了 N 個字元，其中 N 是 is.width()，如果 is.width() > 0，否則 N 是 str.max_size()，
• 流 is 中發生檔案結束條件，或
• 對於 is 中的下一個字元 c，std::isspace(c, is.getloc()) 為 true（此空白字元保留在輸入流中）。

如果沒有提取任何字元，則在 is 上設定 std::ios::failbit，這可能丟擲 std::ios_base::failure。

最後，呼叫 is.width(0) 以取消 std::setw（如果有）的效果。

異常

1) 如果在輸出期間丟擲異常，可能丟擲 std::ios_base::failure。

2) 如果沒有從 is 中提取任何字元（例如，流已到達檔案末尾，或僅包含空白字元），或者在輸入期間丟擲異常，可能丟擲 std::ios_base::failure。

引數

os	-	字元輸出流
is	-	字元輸入流
str	-	要插入或提取的字串

返回值

1) os

2) is

示例

執行此程式碼

#include <iostream>
#include <sstream>
#include <string>
 
int main()
{
    std::string greeting = "Hello, whirled!";
    std::istringstream iss(greeting);
 
    std::string hello_comma, whirled, word;
 
    iss >> hello_comma;
    iss >> whirled;
 
    std::cout << greeting << '\n'
              << hello_comma << '\n' << whirled << '\n';
 
    // Reset the stream
    iss.clear();
    iss.seekg(0);
 
    while (iss >> word)
        std::cout << '+' << word << '\n';
}

輸出

Hello, whirled!
Hello,
whirled!
+Hello,
+whirled!

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 25	C++98	n 是 os.width() 和 str.size() 中較小的一個	n 是它們中較大的一個
LWG 90	C++98	曾使用 std::isspace(c, getloc()) 檢查 空格，但 getloc 未在 <string> 中宣告	替換 getloc() 為 is.getloc()
LWG 91	C++98	operator>> 未行為如同 一個 FormattedInputFunction	行為如同一個 FormattedInputFunction（格式化輸入函式）
LWG 211	C++98	如果未提取任何字元，operator>> 未設定 failbit	設定 failbit
LWG 435	C++98	字元透過 os.rdbuf()->sputn(str.data(), n) 插入， 且 LWG issue 25 的解決方案使得該行為 未定義，如果 os.width() 大於 str.size()	首先確定填充 並插入帶填充的 字元序列
LWG 586	C++98	operator<< 未行為如同 一個 FormattedOutputFunction	行為如同一個 FormattedOutputFunction（格式化輸出函式）

另請參閱

operator<< (C++17)

對 string_view 執行流輸出 (函式模板)