Creates an instance of an oeostream.
This class is designed to
provide an interface and some functionality; however, this class
does not define a data target and therefore writing data to an
instance of this is equivalent to writing to null.

Use of these operators executes the specified function (‘f’) on
the stream in question. In order for proper compilation and
execution, the specified function must be prototyped according
to the API shown above.

oeostream&operator<<(oeistream&)

Fills the current stream by reading and storing all of the data
from the specified oeistream stream.

Flushes the remaining data in the output buffer and then closes the
stream. After the stream has been closed, it is then initialized
and ready to be opened. Before this stream can be reused, it must
first be opened with oeostream.open.
Any attempts to write to this stream
before it has been opened will fail.

Flushes the remaining data in the output buffer onto the stream and
returns whether or not it was successful. Explicit calls to this
function are only necessary when one needs to make sure that all of
the data that has been stored in the output buffer is actually on
the output stream at that time. The output buffer is automatically
flushed when it becomes full.

Opens the output stream to the specified sources. Passing a ‘name’
parameter will result in invocation of a protected virtual method
to appropriate handle the specified output source. Passing a
pointer to a character buffer along with the buffer’s size will
result in the stream wrapping the ‘buffer’ and using that as the
stream data destination. Returns whether or not data can now be
written to the stream.