Traditional-warnings.html 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
  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-2023 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 6.7, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  20. <title>Traditional warnings (The C Preprocessor)</title>
  21. <meta name="description" content="Traditional warnings (The C Preprocessor)">
  22. <meta name="keywords" content="Traditional warnings (The C Preprocessor)">
  23. <meta name="resource-type" content="document">
  24. <meta name="distribution" content="global">
  25. <meta name="Generator" content="makeinfo">
  26. <link href="index.html" rel="start" title="Top">
  27. <link href="Index-of-Directives.html" rel="index" title="Index of Directives">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Traditional-Mode.html" rel="up" title="Traditional Mode">
  30. <link href="Implementation-Details.html" rel="next" title="Implementation Details">
  31. <link href="Traditional-miscellany.html" rel="prev" title="Traditional miscellany">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.indentedblock {margin-right: 0em}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.lisp {margin-left: 3.2em}
  39. kbd {font-style: oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. span.nolinebreak {white-space: nowrap}
  45. span.roman {font-family: initial; font-weight: normal}
  46. span.sansserif {font-family: sans-serif; font-weight: normal}
  47. ul.no-bullet {list-style: none}
  48. -->
  49. </style>
  50. </head>
  51. <body lang="en">
  52. <span id="Traditional-warnings"></span><div class="header">
  53. <p>
  54. Previous: <a href="Traditional-miscellany.html" accesskey="p" rel="prev">Traditional miscellany</a>, Up: <a href="Traditional-Mode.html" accesskey="u" rel="up">Traditional Mode</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index-of-Directives.html" title="Index" rel="index">Index</a>]</p>
  55. </div>
  56. <hr>
  57. <span id="Traditional-warnings-1"></span><h3 class="section">10.4 Traditional warnings</h3>
  58. <p>You can request warnings about features that did not exist, or worked
  59. differently, in traditional C with the <samp>-Wtraditional</samp> option.
  60. GCC does not warn about features of ISO C which you must use when you
  61. are using a conforming compiler, such as the &lsquo;<samp>#</samp>&rsquo; and &lsquo;<samp>##</samp>&rsquo;
  62. operators.
  63. </p>
  64. <p>Presently <samp>-Wtraditional</samp> warns about:
  65. </p>
  66. <ul>
  67. <li> Macro parameters that appear within string literals in the macro body.
  68. In traditional C macro replacement takes place within string literals,
  69. but does not in ISO C.
  70. </li><li> In traditional C, some preprocessor directives did not exist.
  71. Traditional preprocessors would only consider a line to be a directive
  72. if the &lsquo;<samp>#</samp>&rsquo; appeared in column 1 on the line. Therefore
  73. <samp>-Wtraditional</samp> warns about directives that traditional C
  74. understands but would ignore because the &lsquo;<samp>#</samp>&rsquo; does not appear as the
  75. first character on the line. It also suggests you hide directives like
  76. &lsquo;<samp>#pragma</samp>&rsquo; not understood by traditional C by indenting them. Some
  77. traditional implementations would not recognize &lsquo;<samp>#elif</samp>&rsquo;, so it
  78. suggests avoiding it altogether.
  79. </li><li> A function-like macro that appears without an argument list. In some
  80. traditional preprocessors this was an error. In ISO C it merely means
  81. that the macro is not expanded.
  82. </li><li> The unary plus operator. This did not exist in traditional C.
  83. </li><li> The &lsquo;<samp>U</samp>&rsquo; and &lsquo;<samp>LL</samp>&rsquo; integer constant suffixes, which were not
  84. available in traditional C. (Traditional C does support the &lsquo;<samp>L</samp>&rsquo;
  85. suffix for simple long integer constants.) You are not warned about
  86. uses of these suffixes in macros defined in system headers. For
  87. instance, <code>UINT_MAX</code> may well be defined as <code>4294967295U</code>, but
  88. you will not be warned if you use <code>UINT_MAX</code>.
  89. <p>You can usually avoid the warning, and the related warning about
  90. constants which are so large that they are unsigned, by writing the
  91. integer constant in question in hexadecimal, with no U suffix. Take
  92. care, though, because this gives the wrong result in exotic cases.
  93. </p></li></ul>
  94. <hr>
  95. <div class="header">
  96. <p>
  97. Previous: <a href="Traditional-miscellany.html" accesskey="p" rel="prev">Traditional miscellany</a>, Up: <a href="Traditional-Mode.html" accesskey="u" rel="up">Traditional Mode</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index-of-Directives.html" title="Index" rel="index">Index</a>]</p>
  98. </div>
  99. </body>
  100. </html>