basic_istream::get

Článek
03/15/2013

Přečte ze vstupního datového proudu jeden nebo více znaků.

int_type get();
basic_istream<Elem, Tr>& get(
    Elem& _Ch
);
basic_istream<Elem, Tr>& get(
    Elem *_Str,
    streamsize _Count
);
basic_istream<Elem, Tr>& get(
    Elem *_Str,
    streamsize _Count,
    Elem _Delim
);
basic_istream<Elem, Tr>& get(
    basic_streambuf<Elem, Tr>& _Strbuf
);
basic_istream<Elem, Tr>& get(
    basic_streambuf<Elem, Tr>& _Strbuf,
    Elem _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.
_Ch
Znak získat.
_Strbuf
Vyrovnávací paměť ve kterém chcete psát.

Vrácená hodnota

Bez parametrů formuláře get vrátí prvek jako celé číslo nebo konec souboru.Zbývající formuláře vrátit proud (*this).

Poznámky

První z těchto funkcí neformátovaný vstupní extrahuje prvku, pokud možno, jako by se po návratu rdbuf->sbumpc.Jinak vrací traits_type::eof.Pokud funkce extrahuje žádný prvek, volá setstate(failbit).

Druhá funkce extrahuje int_type element meta stejným způsobem.Pokud meta porovná se rovná traits_type::eof, volání funkce setstate(failbit).Jinak jsou uloženy traits_type::to_char_type(meta) v _Ch.Funkce vrátí * Tato.

The third function returns get(_Str, _Count, widen('\n')).

Čtvrtý funkce extrahuje až _Count - 1 prvky a ukládá je do pole začínající _Str.Vždy ukládá char_type po extrakci žádné prvky ukládá.Extrakce přestane v pořadí zkoušek:

Na konec souboru.
Po funkci extrahuje element, který porovnává rovno _Delim, v tom případě je prvek umístit zpět řízené posloupnosti.
Po funkci extrahuje _Count - 1 prvky.

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

Vrátí pátý získat(strbuf, widen("\n")).

Extrahuje prvků šestého funkce a vloží je v strbuf.Extrakce zastaví na konce souboru nebo na prvek, který porovnává rovna _Delim, které nebude extrahován.Zastaví také, bez extrahování dotyčného prvku, pokud kurzor selže nebo vyvolá výjimku (který je zachycena, ale není rethrown).Pokud funkce extrahuje žádné prvky, volá setstate(failbit).V každém případě vrátí funkce * Tato.

Příklad

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

int main( ) 
{
   char c[10];

   c[0] = cin.get( );
   cin.get( c[1] );
   cin.get( &c[2],3 );
   cin.get( &c[4], 4, '7' );

   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

Sdílet prostřednictvím