ffsseettppooss() -- STDIO Function (libc)

Set file-position indicator
#iinncclluuddee <ssttddiioo.hh>
iinntt
ffsseettppooss(_f_p, _p_o_s_i_t_i_o_n)
FFIILLEE *_f_p; ffppooss_tt *_p_o_s_i_t_i_o_n;

ffsseettppooss() resets the file-position indicator.  _f_p points to the file stream
whose indicator is being reset.  _p_o_s_i_t_i_o_n is a value that had been returned
by an earlier call to ffggeettppooss().  It is of type ffppooss_tt, which is defined in
the header ssttddiioo.hh.

Like  the  related  function  ffsseeeekk(),  ffsseettppooss()  clears  the  end-of-file
indicator and undoes  the effects of a previous call  to uunnggeettcc(). The next
operation on _f_p may read or write data.

ffsseettppooss() returns zero if all goes  well.  If an error occurred, it returns
nonzero and sets eerrrrnnoo to an appropriate value.

_E_x_a_m_p_l_e
For an example of this function, see ffggeettppooss().

_S_e_e _A_l_s_o
ffggeettppooss(), ffsseeeekk(), fftteellll(), lliibbcc, rreewwiinndd()
ANSI Standard, section 7.9.9.3

_N_o_t_e_s
The  ANSI Standard  designed ffsseettppooss()  to  be used  with files  whose file
position cannot  be represented within  a lloonngg. Under  COHERENT, it behaves
the same as ffsseeeekk().

If you wish to use ffsseettppooss(),  you should first call the function ffggeettppooss()
to obtain value of the file-position indicator.

You can  also use the  functions fftteellll() and ffsseett(),  respectively, to read
and  set  the  file-position  indicator.   However,  code that  uses  these
function may  not be portable  to operating systems other  than COHERENT or
UNIX.
