basic_istream::get

Článek
06/09/2015

Načteme jeden nebo více znaků vstupního datového proudu.

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ů 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.
_Ch
Chcete-li získat znak.
_Strbuf
Buffer, do kterého chcete zapisovat.

Vrácená hodnota

Formě bez parametrů get vrátí prvek číst jako celé číslo nebo na konec souboru.Zbývající formuláře vrátit do datového proudu (*this).

Poznámky

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

Druhá funkce extrahuje int_type prvku meta stejným způsobem.Pokud meta porovná rovnající se traits_type::eof, volání funkce setstate(failbit).V opačném případě se ukládá traits_type::to_char_type(meta) v _Ch.Vrátí funkce * to.

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

Čtvrtá funkce extrahuje až _Count - 1 prvky a ukládá je v matici počínaje _Str.Vždy ukládá char_type po některé prvky ukládá extrahovány.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 je posunut na řízené sekvenci.
Po funkce extrahuje _Count - 1 prvků.

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

Pátý vrátí získat(strbuf, widen('\n')).

Šestá funkce výpisy prvků a vloží je do strbuf.Extrakce zastaví na konci souboru nebo na prvek, který porovnává rovná _Delim, který není extrahována.Zastaví také, aniž by dotyčná, vyjmutí, vložení se nezdaří nebo vyvolá výjimku (což je zachycena, ale nejsou vyvolány).Pokud funkce extrahuje žádné prvky, volá setstate(failbit).V každém případě vrátí funkce * to.

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

iostream – programování

iostreams – konvence

Sdílet prostřednictvím