

va_end()                Variable Arguments               va_end()




Tidy up after traversal of argument list

#iinncclluuddee <ssttddaarrgg.hh>
vvooiidd vvaa_eenndd(_l_i_s_t_p_t_r)
vvaa_lliisstt _l_i_s_t_p_t_r;

vvaa_eenndd hheellppss  ttoo ttiiddyy  uupp aa ffuunnccttiioonn  aafftteerr iitt hhaass  ttrraavveerrsseedd tthhee
aarrgguummeenntt  lliisstt ffoorr  aa ffuunnccttiioonn  tthhaatt ttaakkeess  aa vvaarriiaabbllee  nnuummbbeerr ooff
aarrgguummeennttss.  IItt  ccaann bbee uusseedd  wwiitthh ffuunnccttiioonnss tthhaatt  ttaakkee aa vvaarriiaabbllee
nnuummbbeerr ooff aarrgguummeennttss, ssuucchh aass  pprriinnttff or ssccaannff, to help write such
functions portably.   It should be used  with the routines vvaa_aarrgg
and vvaa_ssttaarrtt from within  a function that takes a variable number
of arguments.

_l_i_s_t_p_t_r is of type vvaa_lliisstt, which is declared in header ssttddaarrgg.hh.
_l_i_s_t_p_t_r must first have been initialized by macro vvaa_ssttaarrtt.

The ANSI  Standard states that the manner  of ``tidying up'' that
vvaa_eenndd  performs  will vary  from  one  computing environment  to
another.  In  many computing environments, vvaa_eenndd  is not needed,
and it may be implemented as an empty function.

***** Example *****

For  an example  of  this function,  see the  entry for  vvaarriiaabbllee
aarrgguummeennttss.

***** See Also *****

vvaarriiaabbllee aarrgguummeennttss

***** Notes *****

If vvaa_lliisstt  is not initialized  by vvaa_ssttaarrtt, or if  vvaa_eenndd is not
called before a  function with variable arguments exits, then the
behavior of vvaa_eenndd is undefined.




















COHERENT Lexicon                                           Page 1


