Import Upstream version 20180207
[hcoop/debian/mlton.git] / doc / guide / localhost / IntroduceLoops
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <meta name="generator" content="AsciiDoc 8.6.9">
6 <title>IntroduceLoops</title>
7 <link rel="stylesheet" href="./asciidoc.css" type="text/css">
8 <link rel="stylesheet" href="./pygments.css" type="text/css">
9
10
11 <script type="text/javascript" src="./asciidoc.js"></script>
12 <script type="text/javascript">
13 /*<![CDATA[*/
14 asciidoc.install();
15 /*]]>*/
16 </script>
17 <link rel="stylesheet" href="./mlton.css" type="text/css">
18 </head>
19 <body class="article">
20 <div id="banner">
21 <div id="banner-home">
22 <a href="./Home">MLton 20180207</a>
23 </div>
24 </div>
25 <div id="header">
26 <h1>IntroduceLoops</h1>
27 </div>
28 <div id="content">
29 <div id="preamble">
30 <div class="sectionbody">
31 <div class="paragraph"><p><a href="IntroduceLoops">IntroduceLoops</a> is an optimization pass for the <a href="SSA">SSA</a>
32 <a href="IntermediateLanguage">IntermediateLanguage</a>, invoked from <a href="SSASimplify">SSASimplify</a>.</p></div>
33 </div>
34 </div>
35 <div class="sect1">
36 <h2 id="_description">Description</h2>
37 <div class="sectionbody">
38 <div class="paragraph"><p>This pass rewrites any <a href="SSA">SSA</a> function that calls itself in tail
39 position into one with a local loop and no self tail calls.</p></div>
40 <div class="paragraph"><p>A <a href="SSA">SSA</a> function like</p></div>
41 <div class="listingblock">
42 <div class="content monospaced">
43 <pre>fun F (arg_0, arg_1) = L_0 ()
44 ...
45 L_16 (x_0)
46 ...
47 F (z_0, z_1) Tail
48 ...</pre>
49 </div></div>
50 <div class="paragraph"><p>becomes</p></div>
51 <div class="listingblock">
52 <div class="content monospaced">
53 <pre>fun F (arg_0', arg_1') = loopS_0 ()
54 loopS_0 ()
55 loop_0 (arg_0', arg_1')
56 loop_0 (arg_0, arg_1)
57 L_0 ()
58 ...
59 L_16 (x_0)
60 ...
61 loop_0 (z_0, z_1)
62 ...</pre>
63 </div></div>
64 </div>
65 </div>
66 <div class="sect1">
67 <h2 id="_implementation">Implementation</h2>
68 <div class="sectionbody">
69 <div class="ulist"><ul>
70 <li>
71 <p>
72 <a href="https://github.com/MLton/mlton/blob/master/mlton/ssa/introduce-loops.fun"><span class="monospaced">introduce-loops.fun</span></a>
73 </p>
74 </li>
75 </ul></div>
76 </div>
77 </div>
78 <div class="sect1">
79 <h2 id="_details_and_notes">Details and Notes</h2>
80 <div class="sectionbody">
81 <div class="paragraph"><p></p></div>
82 </div>
83 </div>
84 </div>
85 <div id="footnotes"><hr></div>
86 <div id="footer">
87 <div id="footer-text">
88 </div>
89 <div id="footer-badges">
90 </div>
91 </div>
92 </body>
93 </html>