📄 variadic-macros.html
字号:
<html lang="en">
<head>
<title>Using the GNU Compiler Collection (GCC)</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNU Compiler Collection (GCC)">
<meta name="generator" content="makeinfo 4.3">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home">
<!--
Copyright © 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
<p>Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Funding
Free Software", the Front-Cover texts being (a) (see below), and with
the Back-Cover Texts being (b) (see below). A copy of the license is
included in the section entitled "GNU Free Documentation License".
<p>(a) The FSF's Front-Cover Text is:
<p>A GNU Manual
<p>(b) The FSF's Back-Cover Text is:
<p>You have freedom to copy and modify this GNU Manual, like GNU
software. Copies published by the Free Software Foundation raise
funds for GNU development.-->
</head>
<body>
<div class="node">
<p>
Node:<a name="Variadic%20Macros">Variadic Macros</a>,
Next:<a rel="next" accesskey="n" href="Escaped-Newlines.html#Escaped%20Newlines">Escaped Newlines</a>,
Previous:<a rel="previous" accesskey="p" href="Empty-Structures.html#Empty%20Structures">Empty Structures</a>,
Up:<a rel="up" accesskey="u" href="C-Extensions.html#C%20Extensions">C Extensions</a>
<hr><br>
</div>
<h3 class="section">Macros with a Variable Number of Arguments.</h3>
<p>In the ISO C standard of 1999, a macro can be declared to accept a
variable number of arguments much as a function can. The syntax for
defining the macro is similar to that of a function. Here is an
example:
<pre class="smallexample"> #define debug(format, ...) fprintf (stderr, format, __VA_ARGS__)
</pre>
<p>Here <code>...</code> is a <dfn>variable argument</dfn>. In the invocation of
such a macro, it represents the zero or more tokens until the closing
parenthesis that ends the invocation, including any commas. This set of
tokens replaces the identifier <code>__VA_ARGS__</code> in the macro body
wherever it appears. See the CPP manual for more information.
<p>GCC has long supported variadic macros, and used a different syntax that
allowed you to give a name to the variable arguments just like any other
argument. Here is an example:
<pre class="example"> #define debug(format, args...) fprintf (stderr, format, args)
</pre>
<p>This is in all ways equivalent to the ISO C example above, but arguably
more readable and descriptive.
<p>GNU CPP has two further variadic macro extensions, and permits them to
be used with either of the above forms of macro definition.
<p>In standard C, you are not allowed to leave the variable argument out
entirely; but you are allowed to pass an empty argument. For example,
this invocation is invalid in ISO C, because there is no comma after
the string:
<pre class="example"> debug ("A message")
</pre>
<p>GNU CPP permits you to completely omit the variable arguments in this
way. In the above examples, the compiler would complain, though since
the expansion of the macro still has the extra comma after the format
string.
<p>To help solve this problem, CPP behaves specially for variable arguments
used with the token paste operator, <code>##</code>. If instead you write
<pre class="smallexample"> #define debug(format, ...) fprintf (stderr, format, ## __VA_ARGS__)
</pre>
<p>and if the variable arguments are omitted or empty, the <code>##</code>
operator causes the preprocessor to remove the comma before it. If you
do provide some variable arguments in your macro invocation, GNU CPP
does not complain about the paste operation and instead places the
variable arguments after the comma. Just like any other pasted macro
argument, these arguments are not macro expanded.
</body></html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -