Udostępnij za pośrednictwem

getline

  • Artykuł

Wyodrębnij ciągi ze strumienia wejściowego wiersz po wierszu.

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
   );

Parametry

  • _Istr
    Strumień wejściowy, z którego ma być ekstrahowany ciąg.

  • _Str
    Ciąg, w którym są odczytywane znaki ze strumienia wejściowego.

  • _Delim
    Ogranicznik linii.

Wartość zwracana

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

Druga funkcja zastępuje sekwencję kontrolowane przez _Str z sekwencji elementów ekstrahowana ze strumienia _Istr.

Pozostałe funkcje są analogs poprzednie, ale z Lvalues i Rvalues.

Uwagi

W celu testowania ekstrakcji zatrzymuje:

  • Na koniec pliku.

  • Po funkcji wyodrębnia element, który porównuje równą delim, w którym to przypadku element jest ponownie wprowadzane ani dołączane do kontrolowanego sekwencji.

  • Po wyodrębnia funkcji str.max_size elementów, w którym to przypadku wywołania funkcji setstate(ios_base::failbit).

Jeśli funkcja ekstrakty żadnych elementów, wywołuje setstate(failbit).W każdym przypadku zwraca _Istr.

Przykład

Zobacz string::getline na przykład za pomocą getline.

Wymagania

Nagłówek: <string>

Obszar nazw: std

Zobacz też

Informacje

<string>

basic_string Class

string::getline

Inne zasoby

<string> Członkowie

basic_string członkowie