view doc/posix-functions/va_arg.texi @ 16799:49a21ae0897b

doc: Mention reason for replacement on glibc/Linux systems. * doc/posix-functions/dprintf.texi: Mention the problem with special 'long double' values. * doc/posix-functions/fprintf.texi: Likewise. * doc/posix-functions/printf.texi: Likewise. * doc/posix-functions/snprintf.texi: Likewise. * doc/posix-functions/sprintf.texi: Likewise. * doc/posix-functions/vdprintf.texi: Likewise. * doc/posix-functions/vfprintf.texi: Likewise. * doc/posix-functions/vprintf.texi: Likewise. * doc/posix-functions/vsnprintf.texi: Likewise. * doc/posix-functions/vsprintf.texi: Likewise. * doc/posix-functions/fcntl.texi: Add glibc/Linux to the list of platforms with F_DUPFD_CLOEXEC problems. * doc/posix-functions/glob.texi: Mention which platforms are affected by the problem with symbolic links. * doc/posix-functions/linkat.texi: Mention the problem with AT_SYMLINK_FOLLOW on Linux.
author Bruno Haible <bruno@clisp.org>
date Sun, 22 Apr 2012 16:43:29 +0200
parents bb0ceefd22dc
children
line wrap: on
line source

@node va_arg
@section @code{va_arg}
@findex va_arg

POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/va_arg.html}

Gnulib module: ---

Portability problems fixed by Gnulib:
@itemize
@end itemize

Portability problems not fixed by Gnulib:
@itemize
@item
The second argument of @code{va_arg} must be a type that is invariant under
the ``default argument promotions'' (ISO C 99 6.5.2.2 paragraph 6).  This
means that the following are not valid here:
@table @asis
@item @samp{float}
Use @samp{double} instead.
@item @samp{bool}
Use @samp{int} instead.
@item Integer types smaller than @samp{int}.
Use @samp{int} or @samp{unsigned int} instead.
@end table

This is a portability problem because you don't know the width of some
abstract types like @code{uid_t}, @code{gid_t}, @code{mode_t}.  So, instead of
@smallexample
mode = va_arg (ap, mode_t);
@end smallexample
you have to write
@smallexample
mode = (sizeof (mode_t) < sizeof (int)
        ? va_arg (ap, int)
        : va_arg (ap, mode_t));
@end smallexample
@end itemize