Directives-Within-Macro-Arguments.html 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1987-2017 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation. A copy of
  7. the license is included in the
  8. section entitled "GNU Free Documentation License".
  9. This manual contains no Invariant Sections. The Front-Cover Texts are
  10. (a) (see below), and the Back-Cover Texts are (b) (see below).
  11. (a) The FSF's Front-Cover Text is:
  12. A GNU Manual
  13. (b) The FSF's Back-Cover Text is:
  14. You have freedom to copy and modify this GNU Manual, like GNU
  15. software. Copies published by the Free Software Foundation raise
  16. funds for GNU development. -->
  17. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <title>The C Preprocessor: Directives Within Macro Arguments</title>
  20. <meta name="description" content="The C Preprocessor: Directives Within Macro Arguments">
  21. <meta name="keywords" content="The C Preprocessor: Directives Within Macro Arguments">
  22. <meta name="resource-type" content="document">
  23. <meta name="distribution" content="global">
  24. <meta name="Generator" content="makeinfo">
  25. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  26. <link href="index.html#Top" rel="start" title="Top">
  27. <link href="Index-of-Directives.html#Index-of-Directives" rel="index" title="Index of Directives">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Macros.html#Macros" rel="up" title="Macros">
  30. <link href="Macro-Pitfalls.html#Macro-Pitfalls" rel="next" title="Macro Pitfalls">
  31. <link href="Undefining-and-Redefining-Macros.html#Undefining-and-Redefining-Macros" rel="prev" title="Undefining and Redefining Macros">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.smallquotation {font-size: smaller}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.indentedblock {margin-left: 3.2em}
  39. div.lisp {margin-left: 3.2em}
  40. div.smalldisplay {margin-left: 3.2em}
  41. div.smallexample {margin-left: 3.2em}
  42. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  43. div.smalllisp {margin-left: 3.2em}
  44. kbd {font-style:oblique}
  45. pre.display {font-family: inherit}
  46. pre.format {font-family: inherit}
  47. pre.menu-comment {font-family: serif}
  48. pre.menu-preformatted {font-family: serif}
  49. pre.smalldisplay {font-family: inherit; font-size: smaller}
  50. pre.smallexample {font-size: smaller}
  51. pre.smallformat {font-family: inherit; font-size: smaller}
  52. pre.smalllisp {font-size: smaller}
  53. span.nocodebreak {white-space:nowrap}
  54. span.nolinebreak {white-space:nowrap}
  55. span.roman {font-family:serif; font-weight:normal}
  56. span.sansserif {font-family:sans-serif; font-weight:normal}
  57. ul.no-bullet {list-style: none}
  58. -->
  59. </style>
  60. </head>
  61. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  62. <a name="Directives-Within-Macro-Arguments"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="Macro-Pitfalls.html#Macro-Pitfalls" accesskey="n" rel="next">Macro Pitfalls</a>, Previous: <a href="Undefining-and-Redefining-Macros.html#Undefining-and-Redefining-Macros" accesskey="p" rel="prev">Undefining and Redefining Macros</a>, Up: <a href="Macros.html#Macros" accesskey="u" rel="up">Macros</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index-of-Directives.html#Index-of-Directives" title="Index" rel="index">Index</a>]</p>
  66. </div>
  67. <hr>
  68. <a name="Directives-Within-Macro-Arguments-1"></a>
  69. <h3 class="section">3.9 Directives Within Macro Arguments</h3>
  70. <a name="index-macro-arguments-and-directives"></a>
  71. <p>Occasionally it is convenient to use preprocessor directives within
  72. the arguments of a macro. The C and C++ standards declare that
  73. behavior in these cases is undefined. GNU CPP
  74. processes arbitrary directives within macro arguments in
  75. exactly the same way as it would have processed the directive were the
  76. function-like macro invocation not present.
  77. </p>
  78. <p>If, within a macro invocation, that macro is redefined, then the new
  79. definition takes effect in time for argument pre-expansion, but the
  80. original definition is still used for argument replacement. Here is a
  81. pathological example:
  82. </p>
  83. <div class="smallexample">
  84. <pre class="smallexample">#define f(x) x x
  85. f (1
  86. #undef f
  87. #define f 2
  88. f)
  89. </pre></div>
  90. <p>which expands to
  91. </p>
  92. <div class="smallexample">
  93. <pre class="smallexample">1 2 1 2
  94. </pre></div>
  95. <p>with the semantics described above.
  96. </p>
  97. </body>
  98. </html>