Udostępnij za pośrednictwem


basic_istream::getline

Pobiera wiersz z strumień wejściowy.

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 należy zakończyć Odczyt, jeśli wystąpi przed _Count.

  • _Str
    Ciąg, w którym chcesz pisać.

Wartość zwracana

Strumień (* to).

Uwagi

Pierwszy z nich niesformatowane dane wejściowe zwraca wartość funkcji getline(_Str, _Count, widen("\n")).

Druga funkcja wyodrębnia do _Count - 1 elementy i przechowuje je w początek tablicy w _Str.Zawsze przechowuje ciąg znaków zakończenie po wszelkich wyodrębnionych elementów przechowywanych w niej.W celu testowania ekstrakcji zatrzymuje:

  • Na końcu pliku.

  • Po funkcji wyodrębnia elementem, który porównuje równa _Delim, w którym to przypadku element jest przesunięty ani dołączane do kontrolowanej sekwencji.

  • Po wyodrębnia funkcja _Count - 1 elementów.

Jeśli funkcja wyodrębnia żadnych elementów lub _Count - 1 wywołuje elementów, 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>

Przestrzeń nazw: std

Zobacz też

Informacje

basic_istream — Klasa

iostream Programming

Konwencje iostream