Return to va_arg CVS log

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

Annotation of coherent/a/usr/man/MULTI/va_arg, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: va_arg()                Variable Arguments               va_arg()
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Return pointer to next argument in argument list
        !             9: 
        !            10: #iinncclluuddee <ssttddaarrgg.hh>
        !            11: _t_y_p_e_n_a_m_e *vvaa_aarrgg(_l_i_s_t_p_t_r, _t_y_p_e_n_a_m_e)
        !            12: vvaa_lliisstt _l_i_s_t_p_t_r, _t_y_p_e_n_a_m_e;
        !            13: 
        !            14: vvaa_aarrgg  returns a  pointer to  the next  argument in  an argument
        !            15: list.  It can be used  with functions that take a variable number
        !            16: of  arguments,  such  as pprriinnttff  or  ssccaannff,  to  help write  such
        !            17: functions portably.   It is always used  with vvaa_eenndd and vvaa_ssttaarrtt
        !            18: within a function that takes a variable number of arguments.
        !            19: 
        !            20: _l_i_s_t_p_t_r  is  of type  vvaa_lliisstt,  which is  defined  in the  header
        !            21: ssttddaarrgg.hh.  This object  must first  be  initialized by  the macro
        !            22: vvaa_ssttaarrtt.
        !            23: 
        !            24: _t_y_p_e_n_a_m_e is the name of the  type for which vvaa_aarrgg is to return a
        !            25: pointer.  For example, if you  wish vvaa_aarrgg to return a pointer to
        !            26: an integer, _t_y_p_e_n_a_m_e should be of type iinntt.
        !            27: 
        !            28: vvaa_aarrgg can only  handle ``standard'' data types, i.e., those data
        !            29: types  that  can  be  transformed  to  pointers by  appending  an
        !            30: asterisk `*'.
        !            31: 
        !            32: ***** Example *****
        !            33: 
        !            34: For  an  example  of  this  macro,  see the  entry  for  vvaarriiaabbllee
        !            35: aarrgguummeennttss.
        !            36: 
        !            37: ***** See Also *****
        !            38: 
        !            39: vvaarriiaabbllee aarrgguummeennttss
        !            40: 
        !            41: ***** Notes *****
        !            42: 
        !            43: If there is no next argument for vvaa_aarrgg to handle, or if _t_y_p_e_n_a_m_e
        !            44: is incorrect, then the behavior of vvaa_aarrgg is undefined.
        !            45: 
        !            46: The ANSI  Standard demands that  vvaa_aarrgg be implemented  only as a
        !            47: macro.  If  its macro definition is  suppressed within a program,
        !            48: its behavior is undefined.
        !            49: 
        !            50: 
        !            51: 
        !            52: 
        !            53: 
        !            54: 
        !            55: 
        !            56: 
        !            57: 
        !            58: 
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 

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