getline

  • 發行項

擷取輸入資料流--琵式中的字串。

template<class CharType, class Traits, class Allocator>
   basic_istream<CharType, Traits>& getline(
      basic_istream<CharType, Traits>& _Istr,
      basic_string<CharType, Traits, Allocator>& _Str
   );
template<class CharType, class Traits, class Allocator>
   basic_istream< CharType, Traits >& getline(
       basic_istream< CharType, Traits >& _Istr,
       basic_string< CharType, Traits, Allocator >& _Str,
       CharType _Delim
   );
template<class Allocator, class Traits, class Allocator>
   basic_istream< Allocator, Traits >& getline(
        basic_istream< Allocator, Traits >&& _Istr,
        basic_string< Allocator, Traits, Allocator >& _Str
   );
template<class CharType, class Traits, class Allocator>
   basic_istream<CharType, Traits>& getline(
      basic_istream<CharType, Traits>&& _Istr,
      basic_string<CharType, Traits, Allocator>& _Str,
      const CharType _Delim
   );

參數

  • _Istr
    字串是要擷取的輸入資料流。

  • _Str
    字串，其中會從輸入資料流讀取字元。

  • _Delim
    列分隔符號。

傳回值

The first function returns getline( _Istr, _Str, _Istr.widen( '\n' ) ).

第二個函式來取代所控制的順序_Str與擷取自資料流項目的序列_Istr。

其餘的函式是之前的不過有的 analogs 值和 Rvalues。

備註

為了測試，會停止擷取：

  • 在檔案結尾。

  • 此函式擷取會比較為相等的項目之後 delim，在此情況下的項目不會也放回不附加到受控制序列。

  • 此函式會擷取之後str.max_size 元件，在這種情況下函式呼叫setstate(ios_base::failbit)。

如果函式會不擷取任何項目，它會呼叫setstate(failbit)。在任何情況下，它會傳回_Istr。

範例

請參閱string::getline的使用範例， getline。

需求

標頭: <string>

Namespace: 標準

請參閱

參考

<string>

basic_string Class

string::getline

其他資源

<string> 成員

basic_string 成員