rreewwiinnddddiirr() -- General Function (libc)

Rewind a directory stream
#iinncclluuddee <ddiirreenntt.hh>
vvooiidd rreewwiinnddddiirr(_d_i_r_p)
DDIIRR *_d_i_r_p;

The COHERENT function rreewwiinnddddiirr() is one of a set of COHERENT routines that
manipulate  directories  in a  device-independent  manner.   It resets  the
current  position within  the directory  stream pointed to  by _d_i_r_p  to the
beginning of the directory.

rreewwiinnddddiirr() discards  all buffered data for its  data stream.  This ensures
that  your program  knows  about all  modifications to  the directory  that
occurred since the last time the directory stream was opened or rewound.

If  an error  occurs, rreewwiinnddddiirr()  exits and sets  eerrrrnnoo to  an appropriate
value.

_S_e_e _A_l_s_o
cclloosseeddiirr(),  ddiirreenntt.hh, ggeettddeennttss(),  lliibbcc, ooppeennddiirr(),  rreeaaddddiirr(), sseeeekkddiirr(),
tteellllddiirr()
POSIX Standard, section 5.1.2

_N_o_t_e_s
Because directory entries can dynamically appear and disappear, and because
directory contents are buffered  by these routines, an application may need
to continually  rescan a directory  to maintain an accurate  picture of its
active entries.

The COHERENT implementation of the ddiirreenntt routines was written by D. Gwynn.
