Siebel eScript Language Reference > C Language Library Reference > Clib File Input and Output Methods >

Clib Get Relative Cursor Position Method

The Clib Get Relative Cursor Position method gets the position of the file cursor of an open file relative to the beginning of the file. It returns one of the following values:

• If successful, then it returns the current position of the file cursor.
• If not successful, then it returns the following value and stores the error value in the errno property:

  Negative 1

The cursor position in a text file might not correspond exactly with the byte offset in the file. A text file is a file that is not opened in binary mode.

Format

Clib.ftell(filePointer)

The arguments for this method are the same as the arguments for the Clib Clear Error method. For more information, see Arguments for the Clib Clear Error Method.