Preprocessing.html 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- This file documents the GNU Assembler "as".
  4. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: Preprocessing</title>
  15. <meta name="description" content="Using as: Preprocessing">
  16. <meta name="keywords" content="Using as: Preprocessing">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="Syntax.html#Syntax" rel="up" title="Syntax">
  25. <link href="Whitespace.html#Whitespace" rel="next" title="Whitespace">
  26. <link href="Syntax.html#Syntax" rel="prev" title="Syntax">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {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. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="Preprocessing"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Whitespace.html#Whitespace" accesskey="n" rel="next">Whitespace</a>, Up: <a href="Syntax.html#Syntax" accesskey="u" rel="up">Syntax</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Preprocessing-1"></a>
  64. <h3 class="section">3.1 Preprocessing</h3>
  65. <a name="index-preprocessing"></a>
  66. <p>The <code>as</code> internal preprocessor:
  67. </p><ul>
  68. <li> <a name="index-whitespace_002c-removed-by-preprocessor"></a>
  69. adjusts and removes extra whitespace. It leaves one space or tab before
  70. the keywords on a line, and turns any other whitespace on the line into
  71. a single space.
  72. </li><li> <a name="index-comments_002c-removed-by-preprocessor"></a>
  73. removes all comments, replacing them with a single space, or an
  74. appropriate number of newlines.
  75. </li><li> <a name="index-constants_002c-converted-by-preprocessor"></a>
  76. converts character constants into the appropriate numeric values.
  77. </li></ul>
  78. <p>It does not do macro processing, include file handling, or
  79. anything else you may get from your C compiler&rsquo;s preprocessor. You can
  80. do include file processing with the <code>.include</code> directive
  81. (see <a href="Include.html#Include"><code>.include</code></a>). You can use the <small>GNU</small> C compiler driver
  82. to get other &ldquo;CPP&rdquo; style preprocessing by giving the input file a
  83. &lsquo;<samp>.S</samp>&rsquo; suffix. See <a href="../gcc info/Overall-Options.html#Overall-Options">Options Controlling the Kind of
  84. Output</a> in <cite>Using GNU CC</cite>.
  85. </p>
  86. <p>Excess whitespace, comments, and character constants
  87. cannot be used in the portions of the input text that are not
  88. preprocessed.
  89. </p>
  90. <a name="index-turning-preprocessing-on-and-off"></a>
  91. <a name="index-preprocessing_002c-turning-on-and-off"></a>
  92. <a name="index-_0023NO_005fAPP"></a>
  93. <a name="index-_0023APP"></a>
  94. <p>If the first line of an input file is <code>#NO_APP</code> or if you use the
  95. &lsquo;<samp>-f</samp>&rsquo; option, whitespace and comments are not removed from the input file.
  96. Within an input file, you can ask for whitespace and comment removal in
  97. specific portions of the by putting a line that says <code>#APP</code> before the
  98. text that may contain whitespace or comments, and putting a line that says
  99. <code>#NO_APP</code> after this text. This feature is mainly intend to support
  100. <code>asm</code> statements in compilers whose output is otherwise free of comments
  101. and whitespace.
  102. </p>
  103. </body>
  104. </html>