Import Debian changes 20180207-1
[hcoop/debian/mlton.git] / doc / guide / localhost / MLtonCont
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>MLtonCont</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>MLtonCont</h1>\r
27</div>\r
28<div id="content">\r
29<div id="preamble">\r
30<div class="sectionbody">\r
31<div class="listingblock">\r
32<div class="content"><div class="highlight"><pre><span class="k">signature</span><span class="w"> </span><span class="n">MLTON_CONT</span><span class="w"> </span><span class="p">=</span><span class="w"></span>\r
33<span class="w"> </span><span class="k">sig</span><span class="w"></span>\r
34<span class="w"> </span><span class="k">type</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">t</span><span class="w"></span>\r
35\r
36<span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">callcc</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="n">t</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><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"></span>\r
37<span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">isolate</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">unit</span><span class="p">)</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">t</span><span class="w"></span>\r
38<span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">prepend</span><span class="p">:</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">t</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><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;b</span><span class="w"> </span><span class="n">t</span><span class="w"></span>\r
39<span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">throw</span><span class="p">:</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="n">*</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;b</span><span class="w"></span>\r
40<span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">throw&#39;</span><span class="p">:</span><span class="w"> </span><span class="n">&#39;a</span><span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="n">*</span><span class="w"> </span><span class="p">(</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="p">)</span><span class="w"> </span><span class="p">-&gt;</span><span class="w"> </span><span class="n">&#39;b</span><span class="w"></span>\r
41<span class="w"> </span><span class="k">end</span><span class="w"></span>\r
42</pre></div></div></div>\r
43<div class="ulist"><ul>\r
44<li>\r
45<p>\r
46<span class="monospaced">type 'a t</span>\r
47</p>\r
48<div class="paragraph"><p>the type of continuations that expect a value of type <span class="monospaced">'a</span>.</p></div>\r
49</li>\r
50<li>\r
51<p>\r
52<span class="monospaced">callcc f</span>\r
53</p>\r
54<div class="paragraph"><p>applies <span class="monospaced">f</span> to the current continuation. This copies the entire\r
55stack; hence, <span class="monospaced">callcc</span> takes time proportional to the size of the\r
56current stack.</p></div>\r
57</li>\r
58<li>\r
59<p>\r
60<span class="monospaced">isolate f</span>\r
61</p>\r
62<div class="paragraph"><p>creates a continuation that evaluates <span class="monospaced">f</span> in an empty context. This\r
63is a constant time operation, and yields a constant size stack.</p></div>\r
64</li>\r
65<li>\r
66<p>\r
67<span class="monospaced">prepend (k, f)</span>\r
68</p>\r
69<div class="paragraph"><p>composes a function <span class="monospaced">f</span> with a continuation <span class="monospaced">k</span> to create a\r
70continuation that first does <span class="monospaced">f</span> and then does <span class="monospaced">k</span>. This is a\r
71constant time operation.</p></div>\r
72</li>\r
73<li>\r
74<p>\r
75<span class="monospaced">throw (k, v)</span>\r
76</p>\r
77<div class="paragraph"><p>throws value <span class="monospaced">v</span> to continuation <span class="monospaced">k</span>. This copies the entire stack of\r
78<span class="monospaced">k</span>; hence, <span class="monospaced">throw</span> takes time proportional to the size of this stack.</p></div>\r
79</li>\r
80<li>\r
81<p>\r
82<span class="monospaced">throw' (k, th)</span>\r
83</p>\r
84<div class="paragraph"><p>a generalization of throw that evaluates <span class="monospaced">th ()</span> in the context of\r
85<span class="monospaced">k</span>. Thus, for example, if <span class="monospaced">th ()</span> raises an exception or captures\r
86another continuation, it will see <span class="monospaced">k</span>, not the current continuation.</p></div>\r
87</li>\r
88</ul></div>\r
89</div>\r
90</div>\r
91<div class="sect1">\r
92<h2 id="_also_see">Also see</h2>\r
93<div class="sectionbody">\r
94<div class="ulist"><ul>\r
95<li>\r
96<p>\r
97<a href="MLtonContIsolateImplementation">MLtonContIsolateImplementation</a>\r
98</p>\r
99</li>\r
100</ul></div>\r
101</div>\r
102</div>\r
103</div>\r
104<div id="footnotes"><hr></div>\r
105<div id="footer">\r
106<div id="footer-text">\r
107</div>\r
108<div id="footer-badges">\r
109</div>\r
110</div>\r
111</body>\r
112</html>\r