Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ftell(3C)		 Standard C Library Functions		     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 in-
       dicator 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)

SunOS 5.10			  24 Jul 2002			     ftell(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ftell&sektion=3c&manpath=SunOS+5.10>

home | help