Return to va_end CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / MULTI

coherent

va_end()                Variable Arguments               va_end()




Tidy up after traversal of argument list

#iinncclluuddee <ssttddaarrgg.hh>
vvooiidd vvaa_eenndd(_l_i_s_t_p_t_r)
vvaa_lliisstt _l_i_s_t_p_t_r;

vvaa_eenndd hheellppss  ttoo ttiiddyy  uupp aa ffuunnccttiioonn  aafftteerr iitt hhaass  ttrraavveerrsseedd tthhee
aarrgguummeenntt  lliisstt ffoorr  aa ffuunnccttiioonn  tthhaatt ttaakkeess  aa vvaarriiaabbllee  nnuummbbeerr ooff
aarrgguummeennttss.  IItt  ccaann bbee uusseedd  wwiitthh ffuunnccttiioonnss tthhaatt  ttaakkee aa vvaarriiaabbllee
nnuummbbeerr ooff aarrgguummeennttss, ssuucchh aass  pprriinnttff or ssccaannff, to help write such
functions portably.   It should be used  with the routines vvaa_aarrgg
and vvaa_ssttaarrtt from within  a function that takes a variable number
of arguments.

_l_i_s_t_p_t_r is of type vvaa_lliisstt, which is declared in header ssttddaarrgg.hh.
_l_i_s_t_p_t_r must first have been initialized by macro vvaa_ssttaarrtt.

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

***** Example *****

For  an example  of  this function,  see the  entry for  vvaarriiaabbllee
aarrgguummeennttss.

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

vvaarriiaabbllee aarrgguummeennttss

***** Notes *****

If vvaa_lliisstt  is not initialized  by vvaa_ssttaarrtt, or if  vvaa_eenndd is not
called before a  function with variable arguments exits, then the
behavior of vvaa_eenndd is undefined.




















COHERENT Lexicon                                           Page 1

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.