Sdílet prostřednictvím


basic_istream::getline

Řádek se získává ze vstupního datového proudu.

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
    Počet znaků číst z strbuf.

  • _Delim
    Znak, který by měl ukončit čtení, pokud je zjištěna před _Count.

  • _Str
    Řetězec, ve kterém chcete psát.

Vrácená hodnota

Datový proud (* Tato).

Poznámky

První z těchto neformátovaný vstupní vrátí funkce getline(_Str, _Count, widen("\n")).

Druhá funkce extrahuje až _Count - 1 prvky a ukládá je do pole začínající _Str.Vždy ukládá znak ukončení řetězce po extrahované prvků, které uchovává.Extrakce přestane v pořadí zkoušek:

  • Na konec souboru.

  • Po funkci extrahuje element, který porovnává rovno _Delim, v tom případě prvek umístit zpět ani připojen k řízené sekvence.

  • Po funkci extrahuje _Count - 1 prvky.

Pokud funkce extrahuje žádné prvky nebo _Count - 1 prvků, volá setstate(failbit).V každém případě vrátí hodnotu * Tato.

Příklad

// 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;
}
  

Požadavky

Záhlaví: <istream>

Obor názvů: std

Viz také

Referenční dokumentace

basic_istream Class

iostream programování

iostreams konvence