4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <meta name="generator" content="AsciiDoc 8.6.9">
6 <title>MLtonExn</title>
7 <link rel="stylesheet" href="./asciidoc.css" type="text/css">
8 <link rel="stylesheet" href="./pygments.css" type="text/css">
11 <script type="text/javascript" src="./asciidoc.js"></script>
12 <script type="text/javascript">
17 <link rel="stylesheet" href="./mlton.css" type="text/css">
19 <body class="article">
21 <div id="banner-home">
22 <a href="./Home">MLton 20180207</a>
30 <div class="sectionbody">
31 <div class="listingblock">
32 <div class="content"><div class="highlight"><pre><span class="k">signature</span><span class="w"> </span><span class="n">MLTON_EXN</span><span class="w"> </span><span class="p">=</span><span class="w"></span>
33 <span class="w"> </span><span class="k">sig</span><span class="w"></span>
34 <span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">addExnMessager</span><span class="p">:</span><span class="w"> </span><span class="p">(</span><span class="n">exn</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">string</span><span class="w"> </span><span class="n">option</span><span class="p">)</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">unit</span><span class="w"></span>
35 <span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">history</span><span class="p">:</span><span class="w"> </span><span class="n">exn</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">string</span><span class="w"> </span><span class="n">list</span><span class="w"></span>
37 <span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">defaultTopLevelHandler</span><span class="p">:</span><span class="w"> </span><span class="n">exn</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">'a</span><span class="w"></span>
38 <span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">getTopLevelHandler</span><span class="p">:</span><span class="w"> </span><span class="n">unit</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="p">(</span><span class="n">exn</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">unit</span><span class="p">)</span><span class="w"></span>
39 <span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">setTopLevelHandler</span><span class="p">:</span><span class="w"> </span><span class="p">(</span><span class="n">exn</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">unit</span><span class="p">)</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">unit</span><span class="w"></span>
40 <span class="w"> </span><span class="k">val</span><span class="w"> </span><span class="n">topLevelHandler</span><span class="p">:</span><span class="w"> </span><span class="n">exn</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="n">'a</span><span class="w"></span>
41 <span class="w"> </span><span class="k">end</span><span class="w"></span>
42 </pre></div></div></div>
43 <div class="ulist"><ul>
46 <span class="monospaced">addExnMessager f</span>
48 <div class="paragraph"><p>adds <span class="monospaced">f</span> as a pretty-printer to be used by <span class="monospaced">General.exnMessage</span> for
49 converting exceptions to strings. Messagers are tried in order from
50 most recently added to least recently added.</p></div>
54 <span class="monospaced">history e</span>
56 <div class="paragraph"><p>returns call stack at the point that <span class="monospaced">e</span> was first raised. Each
57 element of the list is a file position. The elements are in reverse
58 chronological order, i.e. the function called last is at the front of
60 <div class="paragraph"><p><span class="monospaced">history e</span> will return <span class="monospaced">[]</span> unless the program is compiled with
61 <span class="monospaced">-const 'Exn.keepHistory true'</span>.</p></div>
65 <span class="monospaced">defaultTopLevelHandler e</span>
67 <div class="paragraph"><p>function that behaves as the default top level handler; that is, print
68 out the unhandled exception message for <span class="monospaced">e</span> and exit.</p></div>
72 <span class="monospaced">getTopLevelHandler ()</span>
74 <div class="paragraph"><p>get the top level handler.</p></div>
78 <span class="monospaced">setTopLevelHandler f</span>
80 <div class="paragraph"><p>set the top level handler to the function <span class="monospaced">f</span>. The function <span class="monospaced">f</span>
81 should not raise an exception or return normally.</p></div>
85 <span class="monospaced">topLevelHandler e</span>
87 <div class="paragraph"><p>behaves as if the top level handler received the exception <span class="monospaced">e</span>.</p></div>
93 <div id="footnotes"><hr></div>
95 <div id="footer-text">
97 <div id="footer-badges">