Siebel eScript Language Reference > Siebel eScript Commands > The Clib Object >

Clib.ungetc()Method


This method pushes a character back into a file.

Syntax

Clib.ungetc(char, filePointer)

Parameter
Description
char
The character to push back
filePointer
A file pointer as returned by Clb.fopen()

Returns

The value of char if successful, EOF if unsuccessful.

Usage

When char is put back, it is converted to a byte and is again in the file for subsequent retrieval. Only one character is pushed back. You might want to use this function to read up to, but not including, a newline character. You would then use Clib.ungetc to push the newline character back into the file buffer.

See Also

Clib.fgetc() Method and Clib.getc() Method, Clib.fputc() Method and Clib.putc() Method, and Clib.putenv() Method


 Siebel eScript Language Reference 
 Published: 18 April 2003