Correctly report EOF even when overreading
This version includes a bug fix contributed by Johan Meiring where "over
reading" the stream would cause the `eof()' function to incorrectly
return false. This version fixes this behavior.
This version is a bug fix and should be suitable for all users.
See: https://github.com/ancarda/psr7-string-stream/pull/4
Throw StreamUnusableException after close/detach
This commit adjusts the behavior of close and detach to set the body
to null rather than an empty string. All methods that support throwing
an exception will now throw StreamUnusableException to indicate the
stream has been closed and is thus unusable.
The methods that do not have "@throws RuntimeException" in their
docblocks usually return the zero value of their type. The sole
exception is the eof (End of File) function, since both true and false
is wrong; there's no stream to be at the end of. In this case, true is
returned because that's how the existing implementation works; pointer
is at payload length.
StreamUnusableException is a kind of IllegalOperationException, a new
exception that tells upstream callers which function call failed and
why. ReadOnlyStringStream now throws IllegalOperationException when a
user calls the write() method.
Closes #1
Introduce ReadOnlyStringStream
This commit introduces a Read Only version of StringStream
Fix write() to not assume appending is correct
This commit rewrites the `write()' function to check if it's at EOF
before appending. Now the function is able to prepend if at SOF, and
can also overwrite data in the middle of a stream.