Modifiers.html 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1988-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; with the
  7. Invariant Sections being "Funding Free Software", the Front-Cover
  8. Texts being (a) (see below), and with the Back-Cover Texts being (b)
  9. (see below). A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  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>Using the GNU Compiler Collection (GCC): Modifiers</title>
  20. <meta name="description" content="Using the GNU Compiler Collection (GCC): Modifiers">
  21. <meta name="keywords" content="Using the GNU Compiler Collection (GCC): Modifiers">
  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="Option-Index.html#Option-Index" rel="index" title="Option Index">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Constraints.html#Constraints" rel="up" title="Constraints">
  30. <link href="Machine-Constraints.html#Machine-Constraints" rel="next" title="Machine Constraints">
  31. <link href="Multi_002dAlternative.html#Multi_002dAlternative" rel="prev" title="Multi-Alternative">
  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="Modifiers"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="Machine-Constraints.html#Machine-Constraints" accesskey="n" rel="next">Machine Constraints</a>, Previous: <a href="Multi_002dAlternative.html#Multi_002dAlternative" accesskey="p" rel="prev">Multi-Alternative</a>, Up: <a href="Constraints.html#Constraints" accesskey="u" rel="up">Constraints</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
  66. </div>
  67. <hr>
  68. <a name="Constraint-Modifier-Characters"></a>
  69. <h4 class="subsubsection">6.45.3.3 Constraint Modifier Characters</h4>
  70. <a name="index-modifiers-in-constraints"></a>
  71. <a name="index-constraint-modifier-characters"></a>
  72. <p>Here are constraint modifier characters.
  73. </p>
  74. <dl compact="compact">
  75. <dd><a name="index-_003d-in-constraint"></a>
  76. </dd>
  77. <dt>&lsquo;<samp>=</samp>&rsquo;</dt>
  78. <dd><p>Means that this operand is written to by this instruction:
  79. the previous value is discarded and replaced by new data.
  80. </p>
  81. <a name="index-_002b-in-constraint"></a>
  82. </dd>
  83. <dt>&lsquo;<samp>+</samp>&rsquo;</dt>
  84. <dd><p>Means that this operand is both read and written by the instruction.
  85. </p>
  86. <p>When the compiler fixes up the operands to satisfy the constraints,
  87. it needs to know which operands are read by the instruction and
  88. which are written by it. &lsquo;<samp>=</samp>&rsquo; identifies an operand which is only
  89. written; &lsquo;<samp>+</samp>&rsquo; identifies an operand that is both read and written; all
  90. other operands are assumed to only be read.
  91. </p>
  92. <p>If you specify &lsquo;<samp>=</samp>&rsquo; or &lsquo;<samp>+</samp>&rsquo; in a constraint, you put it in the
  93. first character of the constraint string.
  94. </p>
  95. <a name="index-_0026-in-constraint"></a>
  96. <a name="index-earlyclobber-operand"></a>
  97. </dd>
  98. <dt>&lsquo;<samp>&amp;</samp>&rsquo;</dt>
  99. <dd><p>Means (in a particular alternative) that this operand is an
  100. <em>earlyclobber</em> operand, which is written before the instruction is
  101. finished using the input operands. Therefore, this operand may not lie
  102. in a register that is read by the instruction or as part of any memory
  103. address.
  104. </p>
  105. <p>&lsquo;<samp>&amp;</samp>&rsquo; applies only to the alternative in which it is written. In
  106. constraints with multiple alternatives, sometimes one alternative
  107. requires &lsquo;<samp>&amp;</samp>&rsquo; while others do not. See, for example, the
  108. &lsquo;<samp>movdf</samp>&rsquo; insn of the 68000.
  109. </p>
  110. <p>A operand which is read by the instruction can be tied to an earlyclobber
  111. operand if its only use as an input occurs before the early result is
  112. written. Adding alternatives of this form often allows GCC to produce
  113. better code when only some of the read operands can be affected by the
  114. earlyclobber. See, for example, the &lsquo;<samp>mulsi3</samp>&rsquo; insn of the ARM.
  115. </p>
  116. <p>Furthermore, if the <em>earlyclobber</em> operand is also a read/write
  117. operand, then that operand is written only after it&rsquo;s used.
  118. </p>
  119. <p>&lsquo;<samp>&amp;</samp>&rsquo; does not obviate the need to write &lsquo;<samp>=</samp>&rsquo; or &lsquo;<samp>+</samp>&rsquo;. As
  120. <em>earlyclobber</em> operands are always written, a read-only
  121. <em>earlyclobber</em> operand is ill-formed and will be rejected by the
  122. compiler.
  123. </p>
  124. <a name="index-_0025-in-constraint"></a>
  125. </dd>
  126. <dt>&lsquo;<samp>%</samp>&rsquo;</dt>
  127. <dd><p>Declares the instruction to be commutative for this operand and the
  128. following operand. This means that the compiler may interchange the
  129. two operands if that is the cheapest way to make all operands fit the
  130. constraints. &lsquo;<samp>%</samp>&rsquo; applies to all alternatives and must appear as
  131. the first character in the constraint. Only read-only operands can use
  132. &lsquo;<samp>%</samp>&rsquo;.
  133. </p>
  134. <p>GCC can only handle one commutative pair in an asm; if you use more,
  135. the compiler may fail. Note that you need not use the modifier if
  136. the two alternatives are strictly identical; this would only waste
  137. time in the reload pass.
  138. </p></dd>
  139. </dl>
  140. <hr>
  141. <div class="header">
  142. <p>
  143. Next: <a href="Machine-Constraints.html#Machine-Constraints" accesskey="n" rel="next">Machine Constraints</a>, Previous: <a href="Multi_002dAlternative.html#Multi_002dAlternative" accesskey="p" rel="prev">Multi-Alternative</a>, Up: <a href="Constraints.html#Constraints" accesskey="u" rel="up">Constraints</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
  144. </div>
  145. </body>
  146. </html>