basic_istream::get
Jeden lub więcej znaków odczytuje ze strumienia wejściowego.
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
Liczba znaków do odczytu z strbuf._Delim
Znak, który powinien zakończyć odczytu, jeśli zostanie napotkana przed _Count._Str
Ciąg, w którym zapisu._Ch
Aby uzyskać znak._Strbuf
Bufor w którym zapisu.
Wartość zwracana
Bez parametrów formularza Get zwraca element czytane jako liczba całkowita lub koniec pliku.Pozostałe formy zwrotu strumienia (*this).
Uwagi
Pierwszy funkcji wprowadzania niesformatowany wyodrębnia Jeśli to możliwe, element, jakby poprzez zwracanie rdbuf->sbumpc.W przeciwnym razie zwraca traits_type::eof.Jeśli funkcja ekstrakty element nie wywołuje setstate(failbit).
Druga funkcja int_type elementu meta taki sam sposób.Jeśli meta porównuje równa traits_type::eof, wywołania funkcji setstate(failbit).W przeciwnym razie przechowuje traits_type::to_char_type(meta) w _Ch.Funkcja zwraca * to.
The third function returns get(_Str, _Count, widen('\n')).
Funkcja czwarty ekstrakty do _Count - 1 elementy i przechowuje je w początek tablicy w _Str.Zawsze przechowuje char_type po wyodrębnieniu dowolne elementy przechowuje.W celu testowania zatrzymuje ekstrakcji:
Na koniec pliku.
Po funkcji wyodrębnia element, który porównuje równa _Delim, w którym to przypadku element jest ponownie wprowadzane do kontrolowanego sekwencji.
Po wyodrębnia funkcji _Count - 1 elementy.
Jeśli funkcja ekstrakty żadnych elementów, wywołuje setstate(failbit).W każdym przypadku zwraca * to.
Piąty funkcja zwraca uzyskać(strbuf, widen("\n")).
Funkcja szóstego wyodrębnia elementów i wstawia je w strbuf.Ekstrakcja zatrzymuje-file lub element, który porównuje równa _Delim, który nie jest ekstrahowana.Powoduje także zatrzymanie, bez wyodrębniania elementu w danym przypadku wstawiania awarii lub zgłasza wyjątek (która jest złowionych, ale nie rethrown).Jeśli funkcja ekstrakty żadnych elementów, wywołuje setstate(failbit).W każdym przypadku, funkcja zwraca * to.
Przykład
// 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;
}
Wymagania
Nagłówek: <istream>
Obszar nazw: std