Keil Logo

Technical Support

On-Line Manuals

C251 User's Guide

C251 Introduction Compiling Programs Language Extensions Preprocessor Advanced Programming Error Messages Library Reference Library Files Source Code Standard Types jmp_buf va_list Macros CBYTE CVAR CARRAY DARRAY DBYTE DVAR HARRAY HBYTE HVAR NARRAY NBYTE NVAR XARRAY XBYTE XVAR Routines by Category Buffer Manipulation Routines Character Routines Data Conversion Routines Intrinsic Routines Math Routines Memory Allocation Routines Stream I/O Routines String Routines Variable Length Argument Routines Miscellaneous Routines Include Files SFR Definitions absacc.h assert.h ctype.h float.h intrins.h limits.h math.h setjmp.h stdarg.h stddef.h stdio.h stdlib.h string.h Reference _chkdouble_ _chkfloat_ _crol_ _cror_ _getkey _irol_ _iror_ _lrol_ _lror_ _nop_ _testbit_ _tolower _toupper abs acos asin assert atan atan2 atof atoi atol cabs calloc ceil cos cosh exp fabs fcalloc ffree finit_mempool floor fmalloc fmemcpy fmemset frealloc free getchar gets hmemccpy hmemchr hmemcmp hmemcpy hmemmove hmemset hstrcmp hstrcpy hstrlen hstrncpy init_mempool isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit labs log log10 longjmp malloc memccpy memchr memcmp memcpy memmove memset modf offsetof pow printf putchar puts rand realloc scanf setjmp sin sinh sprintf sqrt srand sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strpos strrchr strrpbrk strrpos strspn tan tanh toascii toint tolower toupper ungetchar va_arg va_end va_start vprintf vsprintf xcalloc xfree xinit_mempool xmalloc xmemcpy xmemset xrealloc Appendix

va_arg

Summary
#include <stdarg.h>

type va_arg (
  argptr,      /* optional argument list */
  type);       /* type of next argument */
Description

The va_arg macro is used to extract subsequent arguments from a variable-length argument list referenced by argptr. The type argument specifies the data type of the argument to extract. This macro may be called only once for each argument and must be called in the order of the parameters in the argument list.

The first call to va_arg returns the first argument after the prevparm argument specified in the va_start macro. Subsequent calls to va_arg return the remaining arguments in succession.

Return Value

The va_arg macro returns the value for the specified argument type.

See Also

va_end, va_start

Example
#include <stdarg.h>
#include <stdio.h> /* for printf */

int varfunc (char *buf, int id, ...) {
  va_list tag;

  va_start (tag, id);

  if (id == 0) {
    int arg1;
    char *arg2;
    long arg3;

    arg1 = va_arg (tag, int);
    arg2 = va_arg (tag, char *);
    arg3 = va_arg (tag, long);
  }

  else {
    char *arg1;
    char *arg2;
    long arg3;

    arg1 = va_arg (tag, char *);
    arg2 = va_arg (tag, char *);
    arg3 = va_arg (tag, long);
  }

  va_end (tag);
}

void caller (void) {
  char tmp_buffer [10];

  varfunc (tmp_buffer, 0, 27, "Test Code", 100L);
  varfunc (tmp_buffer, 1, "Test", "Code", 348L);
}
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.