TextReader: Peek

Peek

Returns the next character from the stream without advancing to the next characters.



 Public Function Peek ( ) As Long

Return Values

Long -  The next character in the stream, or -1 if no characters remain in the stream.

Remarks

The Peek method returns an integer value in order to determine whether the end of the file, or another error has occurred. This allows a user to first check if the returned value is -1 before casting it to a Integer type.

The current position of the TextReader is not changed by this operation. The returned value is -1 if no more characters are available.

If the returned value is not -1 then use the Char.ConvertFromInt32 method to convert to an Integer character.

Exceptions

ExceptionCondition
ObjectDisposedExceptionThe TextReader is closed.

See Also

Project CorLib Overview

Class TextReader Overview