sitelogo
peek_char/1/2

retrieve the character at the current stream position.

peek_char(?Char)
peek_char(+Stream, ?Char)

peek_char/1 retrieves the character at the stream position of the current input stream.

peek_char/2 retrieves the character at the stream position of the stream Stream.

The stream position will not be altered by these predicates.

peek_char retrieves the character at the current stream position and unifies it with Char. If the stream position is behind the end of the inputstream, Char will be unified with the atom end_of_file.

Arguments

Stream                 text input stream
Char                   character or end_of_file

Examples

Assume the content of a stream S is abcdefg and the stream position is at the 1st character.

peek_char('a'). Succeeds. The stream position will not be altered.
peek_char(C). Succeeds with substitution(C<-'a'). The stream position will not be altered.

Standard

These predicates are part of the ISO-Prolog Standard.

See also

get_char/1/2, get_code/1/2, peek_code/1/2, put_char/1/2, put_code/1/2, nl/0/1, set_input/1, current_input/1.


Darueber read on...
scroll to top managed with ubiCMS