Function : Extension Manager

VARARG_ADDR - Pass elements of a variable argument list by reference.

#include <global.h>
<type> VARARG_ADDR(

    VARARG_PTR  aap);

Description :

This function is used to pass elements of a variable argument list of an API function in a Extension Manager callback by reference. This function is implemented as a macro.

Platforms that strictly comply to the C standard do not allow passing of variable argument lists by reference using '&' and '*' operators because the standard states that you may get undetermined results. However, you are allowed to pass a variable argument list without these operators. On Linux for zSeries, whenever you pass a variable argument list the contents will always be modified upon returning from the function passing it in as a parameter (assuming some function below accesses the list.) For these types of platforms, the following macros are defined to just pass the list without using the '&' operator. All platforms can still use a variable argument list as a pointer by simply using the VARARG_PTR_P type.

if defined(ZLINUX)

typedef VARARG_PTR VARARG_PTR_P;

define VARARG_ADDR(_AAP) _AAP

define VARARG_DEREF(_AAP) _AAP

define VARARG_COPY __va_copy

else

typedef VARARG_PTR * VARARG_PTR_P;

define VARARG_ADDR(_AAP) &_AAP

define VARARG_DEREF(_AAP) *_AAP

define VARARG_COPY(dest, src) (dest)=(src)

endif

Parameters : Input : aap - Pointer into a variable argument list.

Output : (routine) - The type of element passed by reference.

aap - The address of the variable argument list element.