Siebel eScript Language Reference > Siebel eScript Commands >

File I/O Methods in eScript

Siebel eScript handles file I/O in a manner similar to C and C++. In these languages, files are never read from, or written to, directly. Rather, you must first open a file, most commonly by passing its name to the Clib.fopen() method. (You can also open a file using Clib.tmpfile().) These methods read the file into a buffer in memory and return a file pointer—a pointer to the beginning of the buffer. The data in the buffer is often referred to as a file stream, or simply a stream. Reading and writing occurs relative to the buffer, which is not written to disk unless you explicitly flush the buffer with Clib.fflush() or close the file with Clib.fclose().

Clib supports the following file I/O functions:

• Clib.chdir() Method
• Clib.clearerr() Method
• Clib.getcwd() Method
• Clib.fclose() Method
• Clib.feof() Method
• Clib.fflush() Method
• Clib.fgetc() Method and Clib.getc() Method
• Clib.fgetpos() Method
• Clib.fgets() Method
• Clib.fopen() Method
• Clib.fprintf() Method
• Clib.fputc() Method and Clib.putc() Method
• Clib.fputs() Method
• Clib.fread() Method
• Clib.freopen() Method
• Clib.fscanf() Method
• Clib.fseek() Method
• Clib.fsetpos() Method
• Clib.ftell() Method
• Clib.fwrite() Method
• Clib.mkdir() Method
• Clib.remove() Method
• Clib.rename() Method
• Clib.rewind() Method
• Clib.rmdir() Method
• Clib.sscanf() Method
• Clib.tmpfile() Method
• Clib.tmpnam() Method
• Clib.ungetc()Method

NOTE:  Siebel applications use UTF-16 encoding when writing to a file in Unicode. The first two bytes of the file are always the BOM (Byte Order Mark). When Clib.rewind is called on such a file, it is pointing to the BOM (-257) and not the first valid character. To skip the BOM, call Clib.fgetc/getc once.