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

FreeBSD Manual Pages

  
 
  

home | help
fsetpos(3C)		 Standard C Library Functions		   fsetpos(3C)

NAME
       fsetpos - reposition a file pointer in a	stream

SYNOPSIS
       #include	<stdio.h>

       int fsetpos(FILE	*stream, const fpos_t *pos);

DESCRIPTION
       The  fsetpos() function sets the	file position indicator	for the	stream
       pointed to by stream according to the value of the object pointed to by
       pos, which must be a value obtained from	an earlier call	to fgetpos(3C)
       on the same stream.

       A successful call to fsetpos() function clears the end-of-file  indica-
       tor  for	 the  stream  and undoes any effects of	ungetc(3C) on the same
       stream.	After an fsetpos() call,  the  next  operation	on  an	update
       stream may be either input or output.

RETURN VALUES
       The fsetpos() function returns 0	if it succeeds;	otherwise it returns a
       non-zero	value and sets errno to	indicate the error.

ERRORS
       The fsetpos() function may fail if:

       EBADF	       The file	descriptor underlying stream is	not valid.

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

USAGE
       The  fsetpos()  function	 has  a	transitional interface for 64-bit file
       offsets.	 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), fgetpos(3C),  fopen(3C),  fseek(3C),  ftell(3C),  rewind(3C),
       ungetc(3C), attributes(5), lf64(5), standards(5)

SunOS 5.10			  24 Jul 2002			   fsetpos(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=fsetpos&sektion=3c&manpath=SunOS+5.10>

home | help