Sdílet prostřednictvím


basic_istream::getline

Získá řádek z vstupní proud.

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ů ke čtení 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 (* to).

Poznámky

První z nich neformátovaný vstup vrátí funkce getline(_Str, _Count, widen("\n')).

Druhá funkce extrahuje až _Count - 1 prvky a ukládá je v matici počínaje _Str.Po extrahované prvků, které ukládá vždy ukládá ukončovací znak řetězce.Extrakce zastaví v pořadí zkoušek:

  • Na konec souboru.

  • Po funkce extrahuje element, který porovnává rovnající se _Delim, v takovém případě prvek umístit zpět ani připojen k řízené sekvenci.

  • Po funkce extrahuje _Count - 1 prvků.

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

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 – třída

iostream – programování

iostreams – konvence