BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kungetc - push a character back onto the data transport stream
LIBRARY CALL
int kungetc(
int character,
kfile *file)
INPUT
- character - the character to be put back onto the stream
- file - the kfile pointer associated with the open stream
to the data transport, opened earlier with
kfopen().
OUTPUT
none
RETURN VALUE
The character that was put back on success, EOF if an error
is encountered.
DESCRIPTION
This function is a replacement for the system ungetc()
routine; kungetc() supports all khoros data transport
mechanisms, not just Unix files.
The routine will put a single character back
onto the specified data transport stream, and moves the
data transport pointer back one character. If the
character could not be put back, EOF is returned;
otherwise, the character that is put back is returned.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/kstdio.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.