STDARG.3
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:3k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. STDARG(3)                 Minix Programmer's Manual                  STDARG(3)
  2. NAME
  3.      stdarg - variable argument list
  4. SYNOPSIS
  5.      #include <stdarg.h>
  6.      void va_start(va_list ap, argtypeN parmN)
  7.      type va_arg(va_list ap, type)
  8.      void va_end(va_list ap)
  9. DESCRIPTION
  10.      This set of macros provides a means of writing portable  procedures  that
  11.      accept  variable argument lists.  Routines having variable argument lists
  12.      (such as printf(3)) that do not use stdarg  are  inherently  nonportable,
  13.      since different machines use different argument passing conventions.
  14.      A function that accepts a variable argument list is declared  with  "..."
  15.      at  the  end  of  its  parameter  list.  It must have at least one normal
  16.      argument before the "...".  For example:
  17.           int printf(const char *format, ...) { /* code */ }
  18.           int fprintf(FILE *stream, const char *format, ...) { /* code */ }
  19.      va_list is a type which is used for the variable ap within the body of  a
  20.      variable argument function which is used to traverse the list.
  21.      va_start(ap, parmN) is called to initialize ap to the  beginning  of  the
  22.      list.   The  last true parameter of the function, parmN, must be supplied
  23.      to allow va_start to compute the address of the first variable parameter.
  24.      va_arg(ap, type) will return the next argument in the list pointed to  by
  25.      ap.   Type  is  the type to which the expected argument will be converted
  26.      when passed as an argument.
  27.      Different types can be mixed, but it is up to the routine  to  know  what
  28.      type of argument is expected, since it cannot be determined at runtime.
  29.      va_end(ap) must be used to finish up.
  30.      Multiple  traversals,  each  bracketed  by  va_start  ...   va_end,   are
  31.      possible.
  32. EXAMPLE
  33.          #include <stdarg.h>
  34.          execl(const char *path, ...)
  35.          {
  36.              va_list ap;
  37.              char *args[100];
  38.              int argno = 0;
  39.                                 May 15, 1986                                 1
  40. STDARG(3)                 Minix Programmer's Manual                  STDARG(3)
  41.              va_start(ap, path);
  42.              while ((args[argno++] = va_arg(ap, char *)) != NULL) {}
  43.              va_end(ap);
  44.              return execv(path, args);
  45.          }
  46. NOTES
  47.      It is up to the calling routine to determine  how  many  arguments  there
  48.      are,  since  it  is  not possible to determine this from the stack frame.
  49.      For example, execl passes a null pointer to signal the end of  the  list.
  50.      Printf  can  tell  how  many  arguments  are  supposed to be there by the
  51.      format.
  52.      The macros va_start and va_end may be arbitrarily complex;  for  example,
  53.      va_start  might  contain  an opening brace, which is closed by a matching
  54.      brace in va_end.  Thus, they should only be  used  where  they  could  be
  55.      placed within a single complex statement.
  56. BUGS
  57.      It is impossible to properly show the macros as C declarations as is done
  58.      in  the  synopsis.   They  can never be coded as C functions, because all
  59.      three macros use their arguments  by  address,  and  the  type  field  is
  60.      certainly impossible.  Just look at them as being part of the C language,
  61.      like sizeof.
  62.                                 May 15, 1986                                 2