Import Upstream version 20180207
[hcoop/debian/mlton.git] / doc / guide / localhost / TypeConstructor
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>TypeConstructor</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>TypeConstructor</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>In <a href="StandardML">Standard ML</a>, a type constructor is a function from\r
32types to types. Type constructors can be <em>nullary</em>, meaning that\r
33they take no arguments, as in <span class="monospaced">char</span>, <span class="monospaced">int</span>, and <span class="monospaced">real</span>.\r
34Type constructors can be <em>unary</em>, meaning that they take one\r
35argument, as in <span class="monospaced">array</span>, <span class="monospaced">list</span>, and <span class="monospaced">vector</span>. A program\r
36can define a new type constructor in two ways: a <span class="monospaced">type</span> definition\r
37or a <span class="monospaced">datatype</span> declaration. User-defined type constructors can\r
38can take any number of arguments.</p></div>\r
39<div class="listingblock">\r
40<div class="content"><div class="highlight"><pre><span class="k">datatype</span><span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">T</span><span class="w"> </span><span class="k">of</span><span class="w"> </span><span class="n">int</span><span class="w"> </span><span class="n">*</span><span class="w"> </span><span class="n">real</span><span class="w"> </span><span class="cm">(* 0 arguments *)</span><span class="w"></span>\r
41<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><span class="p">=</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">int</span><span class="w"> </span><span class="cm">(* 1 argument *)</span><span class="w"></span>\r
42<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">t</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="n">A</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="n">B</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><span class="cm">(* 2 arguments *)</span><span class="w"></span>\r
43<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">&#39;c</span><span class="p">)</span><span class="w"> </span><span class="n">t</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">*</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;c</span><span class="p">)</span><span class="w"> </span><span class="cm">(* 3 arguments *)</span><span class="w"></span>\r
44</pre></div></div></div>\r
45<div class="paragraph"><p>Here are the syntax rules for type constructor application.</p></div>\r
46<div class="ulist"><ul>\r
47<li>\r
48<p>\r
49Type constructor application is written in postfix. So, one writes\r
50 <span class="monospaced">int list</span>, not <span class="monospaced">list int</span>.\r
51</p>\r
52</li>\r
53<li>\r
54<p>\r
55Unary type constructors drop the parens, so one writes\r
56 <span class="monospaced">int list</span>, not <span class="monospaced">(int) list</span>.\r
57</p>\r
58</li>\r
59<li>\r
60<p>\r
61Nullary type constructors drop the argument entirely, so one writes\r
62 <span class="monospaced">int</span>, not <span class="monospaced">() int</span>.\r
63</p>\r
64</li>\r
65<li>\r
66<p>\r
67N-ary type constructors use tuple notation; for example,\r
68 <span class="monospaced">(int, real) t</span>.\r
69</p>\r
70</li>\r
71<li>\r
72<p>\r
73Type constructor application associates to the left. So,\r
74 <span class="monospaced">int ref list</span> is the same as <span class="monospaced">(int ref) list</span>.\r
75</p>\r
76</li>\r
77</ul></div>\r
78</div>\r
79</div>\r
80</div>\r
81<div id="footnotes"><hr></div>\r
82<div id="footer">\r
83<div id="footer-text">\r
84</div>\r
85<div id="footer-badges">\r
86</div>\r
87</div>\r
88</body>\r
89</html>\r