Udostępnij za pośrednictwem


basic_istream::getline

Pobiera wiersz ze strumienia wejściowego.

basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count
);
basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count, 
    char_type _Delim
);

Parametry

  • _Count
    Liczba znaków do odczytu z strbuf.

  • _Delim
    Znak, który powinien zakończyć odczytu, jeśli zostanie napotkana przed _Count.

  • _Str
    Ciąg, w którym zapisu.

Wartość zwracana

Strumień (* to).

Uwagi

Pierwszym z nich niesformatowany wprowadzania funkcji zwraca getline(_Str, _Count, widen("\n")).

Druga funkcja ekstrakty do _Count - 1 elementy i przechowuje je w początek tablicy w _Str.Zawsze przechowuje ciąg znaków zakończenie po wyodrębnione elementów, który go przechowuje.W celu testowania zatrzymuje ekstrakcji:

  • Na koniec pliku.

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

  • Po wyodrębnia funkcji _Count - 1 elementy.

Jeśli funkcja wyodrębnia żadnych elementów lub _Count - 1 elementy, wywołuje setstate(failbit).W każdym przypadku zwraca * to.

Przykład

// basic_istream_getline.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main( ) 
{
   char c[10];

   cin.getline( &c[0], 5, '2' );
   cout << c << endl;
}
  

Wymagania

Nagłówek: <istream>

Obszar nazw: std

Zobacz też

Informacje

basic_istream Class

iostream Programowanie

iostreams Konwencji