Udostępnij za pośrednictwem


basic_istream::get

Odczytuje jeden lub więcej znaków z strumień wejściowy.

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 należy zakończyć Odczyt, jeśli wystąpi przed _Count.

  • _Str
    Ciąg, w którym chcesz pisać.

  • _Ch
    Aby uzyskać znak.

  • _Strbuf
    Bufor w którym napisać.

Wartość zwracana

Formularz bez parametrów GET zwraca element czytane jako liczba całkowita lub koniec pliku.Pozostałe formy zwrotu strumienia (*this).

Uwagi

Pierwszy z tych funkcji wprowadzania niesformatowany wyodrębnia, jeśli jest to możliwe, elementu, tak jakby poprzez zwracanie rdbuf->sbumpc.W przeciwnym wypadku zwraca traits_type::eof.Jeśli funkcja ekstrakty żaden element, wywołuje setstate(failbit).

Druga funkcja wyodrębnia int_type element meta tak samo.Jeśli meta porównuje równa się 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 wyodrębnia do _Count - 1 elementy i przechowuje je w początek tablicy w _Str.Zawsze przechowuje char_type po rozpakowaniu dowolne elementy przechowuje.W celu testowania ekstrakcji zatrzymuje:

  • Na końcu pliku.

  • Po funkcji wyodrębnia elementem, który porównuje równa _Delim, w którym to przypadku element jest przywracane do kontrolowanej sekwencji.

  • Po wyodrębnia funkcja _Count - 1 elementów.

Jeśli funkcja ekstrakty żadnych elementów, wywołuje setstate(failbit).W każdym przypadku zwraca * to.

Piąty funkcja zwraca się(strbuf, widen("\n")).

Funkcja szósty wyodrębnia elementy i wstawi je w strbuf.Ekstrakcja zatrzymuje się na końcu pliku lub na element, który porównuje równa _by ogranicznik, którego nie są wyodrębniane.Powoduje także zatrzymanie, bez wyodrębniania odnośna, jeśli to wstawka nie powiedzie się lub zgłasza wyjątek (która jest złowionych, lecz 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>

Przestrzeń nazw: std

Zobacz też

Informacje

basic_istream — Klasa

iostream Programming

Konwencje iostream