ftell man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

FTELL(3C)							     FTELL(3C)

NAME
       ftell, ftello - return a file offset in a stream

SYNOPSIS
       #include <stdio.h>

       long ftell(FILE *stream);

       off_t ftello(FILE *stream);

DESCRIPTION
       The  ftell()  function  obtains	the current value of the file-position
       indicator for the stream pointed to by stream. The ftello() function is
       identical to ftell() except for the return type.

RETURN VALUES
       Upon  successful	 completion, the ftell() and ftello() functions return
       the current value of the file-position indicator for  the  stream  mea‐
       sured  in  bytes from the beginning of the file. Otherwise, they return
       −1 and sets errno to indicate the error.

ERRORS
       The ftell() and ftello() functions will fail if:

       EBADF
		 The file descriptor underlying stream is  not	an  open  file
		 descriptor.

       ESPIPE
		 The  file  descriptor	underlying stream is associated with a
		 pipe, a FIFO, or a socket.

       The ftell() function will fail if:

       EOVERFLOW
		    The current file offset cannot be represented correctly in
		    an object of type long.

       The ftello() function will fail if:

       EOVERFLOW
		    The current file offset cannot be represented correctly in
		    an object of type off_t.

USAGE
       The ftello() function has a transitional interface for 64-bit file off‐
       sets.  See lf64(5).

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Standard	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ MT-Safe	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       lseek(2), fopen(3C), fseek(3C), attributes(5), , standards(5), lf64(5)

				 Jul 24, 2002			     FTELL(3C)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net