of the stream object.  This improves upon Michal Kottman's suggestion
by making it so that EOF can properly be determined on a zero length
string, it also exposes total bytes out, adds documentation, and
testing.