12.3.101 SP_unget_code()

Synopsis

#include <sicstus/sicstus.h>

spio_t_error_code
SP_unget_code(
  SP_stream *stream,
  int item);

Push back a character so it can be read again by subsequent read operations.

Arguments

stream

The stream. Must be a text stream open for input.

item

The character to push back. This must be the same character that was most recently read from stream, e.g. with SP_get_code(). As a special case, -1 can be put back if the last read operation returned end of file, i.e., SPIO_E_END_OF_FILE.

Return Value

On success, the character has been pushed back and will be read by the next read operation. SPIO_S_NOERR or some other success code is returned.

On failure, returns an error code.

See Also

cpg-ref-SP_get_code. Prolog Streams.