BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kungetc - push a character back onto the data transport stream

LIBRARY CALL

int kungetc(
   int    character,
   kfile *file)

INPUT

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.