C++

參考

<string>

string

函式
<string>

std::getline (string)

(1)
istream& getline (istream& is, string& str, char delim);
(2)
istream& getline (istream& is, string& str);
(1)
istream& getline (istream&  is, string& str, char delim);istream& getline (istream&& is, string& str, char delim);
(2)
istream& getline (istream&  is, string& str);istream& getline (istream&& is, string& str);
從流中獲取一行到字串
從is中提取字元並將它們儲存到str中，直到找到分隔符delim（或換行符'\n'，對於(2)）。

如果在is中到達檔案末尾，或者在輸入操作期間發生其他錯誤，提取也會停止。

如果找到分隔符，則提取並丟棄它（即，它不被儲存，並且下一個輸入操作將在其之後開始）。

請注意，呼叫之前str中的任何內容都將被新提取的序列替換。

每個提取的字元都會附加到string，就像呼叫了其成員push_back一樣。

引數

的 C++ 等效檔案是
從中提取字元的istream物件。
str
string物件，提取的行儲存在此處。
呼叫之前字串中的內容（如果有）將被丟棄並替換為提取的行。

返回值

與引數is相同。

如果滿足以下條件，則對此函式的呼叫可能會設定is的任何內部狀態標誌：

flagerror
eofbit在其操作期間到達字元源的末尾。
failbit獲得的輸入不能被解釋為此型別物件的有效文字表示。
在這種情況下，distr保留呼叫之前的引數和內部資料。
請注意，某些eofbit情況也會設定failbit.
badbit發生了上述以外的錯誤。
（有關這些的更多資訊，請參見ios_base::iostate）

此外，在任何這些情況下，如果已使用is的成員函式ios::exceptions設定了相應的標誌，則會丟擲ios_base::failure型別的異常。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
// extract to string
#include <iostream>
#include <string>

int main ()
{
  std::string name;

  std::cout << "Please, enter your full name: ";
  std::getline (std::cin,name);
  std::cout << "Hello, " << name << "!\n";

  return 0;
}

複雜度

未指定，但通常與str的length成線性關係。

迭代器有效性

與str相關的任何迭代器、指標和引用都可能無效。

資料競爭

is和str兩個物件都被修改。

異常安全

基本保證：如果丟擲異常，則is和str都最終處於有效狀態。

另見

istream::getline
獲取行 (公共成員函式)
operator>> (string)
從流中提取字串 (function)