loop_002div.html 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134
  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>GNU Compiler Collection (GCC) Internals: loop-iv</title>
  20. <meta name="description" content="GNU Compiler Collection (GCC) Internals: loop-iv">
  21. <meta name="keywords" content="GNU Compiler Collection (GCC) Internals: loop-iv">
  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="Loop-Analysis-and-Representation.html#Loop-Analysis-and-Representation" rel="up" title="Loop Analysis and Representation">
  30. <link href="Number-of-iterations.html#Number-of-iterations" rel="next" title="Number of iterations">
  31. <link href="Scalar-evolutions.html#Scalar-evolutions" rel="prev" title="Scalar evolutions">
  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="loop_002div"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="Number-of-iterations.html#Number-of-iterations" accesskey="n" rel="next">Number of iterations</a>, Previous: <a href="Scalar-evolutions.html#Scalar-evolutions" accesskey="p" rel="prev">Scalar evolutions</a>, Up: <a href="Loop-Analysis-and-Representation.html#Loop-Analysis-and-Representation" accesskey="u" rel="up">Loop Analysis and Representation</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="IV-analysis-on-RTL"></a>
  69. <h3 class="section">15.6 IV analysis on RTL</h3>
  70. <a name="index-IV-analysis-on-RTL"></a>
  71. <p>The induction variable on RTL is simple and only allows analysis of
  72. affine induction variables, and only in one loop at once. The interface
  73. is declared in <samp>cfgloop.h</samp>. Before analyzing induction variables
  74. in a loop L, <code>iv_analysis_loop_init</code> function must be called on L.
  75. After the analysis (possibly calling <code>iv_analysis_loop_init</code> for
  76. several loops) is finished, <code>iv_analysis_done</code> should be called.
  77. The following functions can be used to access the results of the
  78. analysis:
  79. </p>
  80. <ul>
  81. <li> <code>iv_analyze</code>: Analyzes a single register used in the given
  82. insn. If no use of the register in this insn is found, the following
  83. insns are scanned, so that this function can be called on the insn
  84. returned by get_condition.
  85. </li><li> <code>iv_analyze_result</code>: Analyzes result of the assignment in the
  86. given insn.
  87. </li><li> <code>iv_analyze_expr</code>: Analyzes a more complicated expression.
  88. All its operands are analyzed by <code>iv_analyze</code>, and hence they must
  89. be used in the specified insn or one of the following insns.
  90. </li></ul>
  91. <p>The description of the induction variable is provided in <code>struct
  92. rtx_iv</code>. In order to handle subregs, the representation is a bit
  93. complicated; if the value of the <code>extend</code> field is not
  94. <code>UNKNOWN</code>, the value of the induction variable in the i-th
  95. iteration is
  96. </p>
  97. <div class="smallexample">
  98. <pre class="smallexample">delta + mult * extend_{extend_mode} (subreg_{mode} (base + i * step)),
  99. </pre></div>
  100. <p>with the following exception: if <code>first_special</code> is true, then the
  101. value in the first iteration (when <code>i</code> is zero) is <code>delta +
  102. mult * base</code>. However, if <code>extend</code> is equal to <code>UNKNOWN</code>,
  103. then <code>first_special</code> must be false, <code>delta</code> 0, <code>mult</code> 1
  104. and the value in the i-th iteration is
  105. </p>
  106. <div class="smallexample">
  107. <pre class="smallexample">subreg_{mode} (base + i * step)
  108. </pre></div>
  109. <p>The function <code>get_iv_value</code> can be used to perform these
  110. calculations.
  111. </p>
  112. <hr>
  113. <div class="header">
  114. <p>
  115. Next: <a href="Number-of-iterations.html#Number-of-iterations" accesskey="n" rel="next">Number of iterations</a>, Previous: <a href="Scalar-evolutions.html#Scalar-evolutions" accesskey="p" rel="prev">Scalar evolutions</a>, Up: <a href="Loop-Analysis-and-Representation.html#Loop-Analysis-and-Representation" accesskey="u" rel="up">Loop Analysis and Representation</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>
  116. </div>
  117. </body>
  118. </html>