Import Debian changes 20180207-1
[hcoop/debian/mlton.git] / doc / guide / localhost / Utilities
CommitLineData
7f918cf1
CE
1<!DOCTYPE html>\r
2<html lang="en">\r
3<head>\r
4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">\r
5<meta name="generator" content="AsciiDoc 8.6.9">\r
6<title>Utilities</title>\r
7<link rel="stylesheet" href="./asciidoc.css" type="text/css">\r
8<link rel="stylesheet" href="./pygments.css" type="text/css">\r
9\r
10\r
11<script type="text/javascript" src="./asciidoc.js"></script>\r
12<script type="text/javascript">\r
13/*<![CDATA[*/\r
14asciidoc.install();\r
15/*]]>*/\r
16</script>\r
17<link rel="stylesheet" href="./mlton.css" type="text/css">\r
18</head>\r
19<body class="article">\r
20<div id="banner">\r
21<div id="banner-home">\r
22<a href="./Home">MLton 20180207</a>\r
23</div>\r
24</div>\r
25<div id="header">\r
26<h1>Utilities</h1>\r
27</div>\r
28<div id="content">\r
29<div id="preamble">\r
30<div class="sectionbody">\r
31<div class="paragraph"><p>This page is a collection of basic utilities used in the examples on\r
32various pages. See</p></div>\r
33<div class="ulist"><ul>\r
34<li>\r
35<p>\r
36<a href="InfixingOperators">InfixingOperators</a>, and\r
37</p>\r
38</li>\r
39<li>\r
40<p>\r
41<a href="ProductType">ProductType</a>\r
42</p>\r
43</li>\r
44</ul></div>\r
45<div class="paragraph"><p>for longer discussions on some of these utilities.</p></div>\r
46<div class="listingblock">\r
47<div class="content"><div class="highlight"><pre><span class="cm">(* Operator precedence table *)</span><span class="w"></span>\r
48<span class="k">infix</span><span class="w"> </span><span class="mi">8</span><span class="w"> </span><span class="n">*</span><span class="w"> </span><span class="n">/</span><span class="w"> </span><span class="n">div</span><span class="w"> </span><span class="n">mod</span><span class="w"> </span><span class="cm">(* +1 from Basis Library *)</span><span class="w"></span>\r
49<span class="k">infix</span><span class="w"> </span><span class="mi">7</span><span class="w"> </span><span class="n">+</span><span class="w"> </span><span class="n">-</span><span class="w"> </span><span class="n">^</span><span class="w"> </span><span class="cm">(* +1 from Basis Library *)</span><span class="w"></span>\r
50<span class="k">infixr</span><span class="w"> </span><span class="mi">6</span><span class="w"> </span><span class="n">::</span><span class="w"> </span><span class="n">@</span><span class="w"> </span><span class="cm">(* +1 from Basis Library *)</span><span class="w"></span>\r
51<span class="k">infix</span><span class="w"> </span><span class="mi">5</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">&lt;&gt;</span><span class="w"> </span><span class="n">&gt;</span><span class="w"> </span><span class="n">&gt;=</span><span class="w"> </span><span class="n">&lt;</span><span class="w"> </span><span class="n">&lt;=</span><span class="w"> </span><span class="cm">(* +1 from Basis Library *)</span><span class="w"></span>\r
52<span class="k">infix</span><span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="n">&lt;\</span><span class="w"> </span><span class="n">\&gt;</span><span class="w"></span>\r
53<span class="k">infixr</span><span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="n">&lt;/</span><span class="w"> </span><span class="n">/&gt;</span><span class="w"></span>\r
54<span class="k">infix</span><span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="n">o</span><span class="w"></span>\r
55<span class="k">infix</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="n">&gt;|</span><span class="w"></span>\r
56<span class="k">infixr</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="n">|&lt;</span><span class="w"></span>\r
57<span class="k">infix</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="n">:=</span><span class="w"> </span><span class="cm">(* -2 from Basis Library *)</span><span class="w"></span>\r
58<span class="k">infix</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="n">before</span><span class="w"> </span><span class="n">&amp;</span><span class="w"></span>\r
59\r
60<span class="cm">(* Some basic combinators *)</span><span class="w"></span>\r
61<span class="k">fun</span><span class="w"> </span><span class="n">const</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="p">_</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">x</span><span class="w"></span>\r
62<span class="k">fun</span><span class="w"> </span><span class="n">cross</span><span class="w"> </span><span class="p">(</span><span class="n">f</span><span class="p">,</span><span class="w"> </span><span class="n">g</span><span class="p">)</span><span class="w"> </span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">y</span><span class="p">)</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="p">(</span><span class="n">f</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">g</span><span class="w"> </span><span class="n">y</span><span class="p">)</span><span class="w"></span>\r
63<span class="k">fun</span><span class="w"> </span><span class="n">curry</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="n">y</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">y</span><span class="p">)</span><span class="w"></span>\r
64<span class="k">fun</span><span class="w"> </span><span class="n">fail</span><span class="w"> </span><span class="n">e</span><span class="w"> </span><span class="p">_</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="k">raise</span><span class="w"> </span><span class="n">e</span><span class="w"></span>\r
65<span class="k">fun</span><span class="w"> </span><span class="n">id</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">x</span><span class="w"></span>\r
66\r
67<span class="cm">(* Product type *)</span><span class="w"></span>\r
68<span class="k">datatype</span><span class="w"> </span><span class="p">(</span><span class="n">&#39;a</span><span class="p">,</span><span class="w"> </span><span class="n">&#39;b</span><span class="p">)</span><span class="w"> </span><span class="n">product</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">&amp;</span><span class="w"> </span><span class="k">of</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">*</span><span class="w"> </span><span class="n">&#39;b</span><span class="w"></span>\r
69\r
70<span class="cm">(* Sum type *)</span><span class="w"></span>\r
71<span class="k">datatype</span><span class="w"> </span><span class="p">(</span><span class="n">&#39;a</span><span class="p">,</span><span class="w"> </span><span class="n">&#39;b</span><span class="p">)</span><span class="w"> </span><span class="n">sum</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">INL</span><span class="w"> </span><span class="k">of</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="n">INR</span><span class="w"> </span><span class="k">of</span><span class="w"> </span><span class="n">&#39;b</span><span class="w"></span>\r
72\r
73<span class="cm">(* Some type shorthands *)</span><span class="w"></span>\r
74<span class="k">type</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">uop</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"></span>\r
75<span class="k">type</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">fix</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">uop</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"></span>\r
76<span class="k">type</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">thunk</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">unit</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"></span>\r
77<span class="k">type</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">effect</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">unit</span><span class="w"></span>\r
78<span class="k">type</span><span class="w"> </span><span class="p">(</span><span class="n">&#39;a</span><span class="p">,</span><span class="w"> </span><span class="n">&#39;b</span><span class="p">)</span><span class="w"> </span><span class="n">emb</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="p">(</span><span class="n">&#39;a</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;b</span><span class="p">)</span><span class="w"> </span><span class="n">*</span><span class="w"> </span><span class="p">(</span><span class="n">&#39;b</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;a</span><span class="p">)</span><span class="w"></span>\r
79\r
80<span class="cm">(* Infixing, sectioning, and application operators *)</span><span class="w"></span>\r
81<span class="k">fun</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="n">&lt;\</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="k">fn</span><span class="w"> </span><span class="n">y</span><span class="w"> </span><span class="p">=&gt;</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">y</span><span class="p">)</span><span class="w"></span>\r
82<span class="k">fun</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="n">\&gt;</span><span class="w"> </span><span class="n">y</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="n">y</span><span class="w"></span>\r
83<span class="k">fun</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="n">/&gt;</span><span class="w"> </span><span class="n">y</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="k">fn</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="p">=&gt;</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">y</span><span class="p">)</span><span class="w"></span>\r
84<span class="k">fun</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="n">&lt;/</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="n">x</span><span class="w"></span>\r
85\r
86<span class="cm">(* Piping operators *)</span><span class="w"></span>\r
87<span class="k">val</span><span class="w"> </span><span class="k">op</span><span class="n">&gt;|</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="k">op</span><span class="n">&lt;/</span><span class="w"></span>\r
88<span class="k">val</span><span class="w"> </span><span class="k">op</span><span class="n">|&lt;</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="k">op</span><span class="n">\&gt;</span><span class="w"></span>\r
89</pre></div></div></div>\r
90</div>\r
91</div>\r
92</div>\r
93<div id="footnotes"><hr></div>\r
94<div id="footer">\r
95<div id="footer-text">\r
96</div>\r
97<div id="footer-badges">\r
98</div>\r
99</div>\r
100</body>\r
101</html>\r