Click above to get retro games delivered to your door ever month!

istream::read

Usage

   #include <iostream.hpp>
   istream &istream::read(void *dest, size_t n);

Description

   A raw or binary input function. Attempts to extract n bytes from the
   input stream and to place then at the specified address, dest. If less
   than n characters are transferred because of an end of file condition the
   error state is set to (ios::eofbit|ios::failbit|ios::badbit).

   The number of characters transferred can be determined by an  immediately
   following call to gcount().

Example 

   Thing x;
   ifstream ifs("things.dat");
   ifs.read(&x, sizeof(Thing));

Return Value

   Returns a reference to the istream object for which it was called.