Documentation

Read events from a stream. The events are read from the stream and inserted starting at the position indicated by the specified itereator. A maximum of max events are read. If max is negative, events are read until a end-of-file marker is encounterd or the fail bit is set.

Example:

    // Read events from a file and add them to an event list.
    List l1;
    ifstream inp ("input.xml");
    Read (inp, back_inserter (l1));
    

Returns:

Iterator to next insert position

Parameters:

inp - Input stream
insert - Position where to insert events (output iterator)
max - Maximum number of events to read