std::getline

 

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<=> (直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(直到 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_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>& input,              std::basic_string<CharT, Traits, Allocator>& str, CharT delim );	(1)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>&& input,              std::basic_string<CharT, Traits, Allocator>& str, CharT delim );	(2)	(C++11 起)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>& input,              std::basic_string<CharT, Traits, Allocator>& str );	(3)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>&& input,              std::basic_string<CharT, Traits, Allocator>& str );	(4)	(C++11 起)

getline 從輸入流中讀取字元並將它們放入字串中

1,2) 行為類似於 UnformattedInputFunction，但 input.gcount() 不受影響。在構造並檢查哨兵物件後，執行以下操作：

1) 呼叫 str.erase()。

2) 從 input 提取字元並附加到 str，直到發生以下情況之一（按列出的順序檢查）：

a) input 上的檔案結束條件，在這種情況下，getline 設定 eofbit。

b) 下一個可用的輸入字元是 delim（透過 Traits::eq(c, delim) 測試），在這種情況下，從 input 提取分隔符字元，但不附加到 str。

c) 已儲存 str.max_size() 個字元，在這種情況下，getline 設定 failbit 並返回。

3) 如果由於任何原因（甚至是被丟棄的分隔符）都沒有提取到字元，getline 設定 failbit 並返回。

3,4) 與 getline(input, str, input.widen('\n')) 相同，即預設分隔符是換行符。

引數

input	-	獲取資料的流
str	-	存放資料的字串
delim	-	分隔符字元

返回值

input

注意事項

當消費空白分隔的輸入時（例如 int n; std::cin >> n;），任何跟隨的空白，包括換行符，都將留在輸入流中。然後，當切換到面向行的輸入時，使用 getline 檢索的第一行將只是該空白。在可能不希望出現此行為的情況下，可能的解決方案包括：

• 顯式地額外初始呼叫 getline。
• 使用 std::cin >> std::ws 移除連續空白。
• 使用 cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n'); 忽略輸入行中所有剩餘字元。

示例

以下示例演示瞭如何使用 getline 函式讀取使用者輸入，以及如何逐行或透過 delim 引數按行的一部分處理流。

執行此程式碼

#include <iostream>
#include <sstream>
#include <string>
 
int main()
{
    // greet the user
    std::string name;
    std::cout << "What is your name? ";
    std::getline(std::cin, name);
    std::cout << "Hello " << name << ", nice to meet you.\n";
 
    // read file line by line
    std::istringstream input;
    input.str("1\n2\n3\n4\n5\n6\n7\n");
    int sum = 0;
    for (std::string line; std::getline(input, line);)
        sum += std::stoi(line);
    std::cout << "\nThe sum is " << sum << ".\n\n";
 
    // use separator to read parts of the line
    std::istringstream input2;
    input2.str("a;b;c;d");
    for (std::string line; std::getline(input2, line, ';');)
        std::cout << line << '\n';
}

可能的輸出

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.
 
The sum is 28.
 
a
b
c
d

缺陷報告

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

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 91	C++98	getline 不作為非格式化輸入函式	作為非格式化輸入函式

參見

getline

提取字元直到找到給定字元 (std::basic_istream<CharT,Traits> 的公共成員函式)