Reads the next element from the stream and advances the stream’s position.
When the stream is past the end of the contents, two possible results occur. If the caller supplied a value to the on-end-of-stream: keyword, then that value is returned. Otherwise, read-element throws an <end-of-stream-error>.
open
| stream | An instance of <stream>. |
| on-end-of-stream: | An instance of <object>. The default is $not-supplied. |
| element-or-eof | An instance of <object> or the value on-end-of-stream:. |