Mercurial Hosting > luan
annotate website/src/diff.html @ 367:c207be7cf45d
more documentation
| author | Franklin Schmidt <fschmidt@gmail.com> |
|---|---|
| date | Thu, 16 Apr 2015 18:44:55 -0600 |
| parents | 705e4d6c3dbb |
| children | 7999601586b1 |
| rev | line source |
|---|---|
| 353 | 1 <!DOCTYPE html> |
| 2 <html lang="en"> | |
| 3 <head> | |
| 4 <meta charset="utf-8"> | |
| 5 <meta name="viewport" content="width=device-width, initial-scale=1"> | |
| 6 | |
| 7 <title>Luan Documentation</title> | |
| 8 | |
| 9 <link href="http://www.simplyhtml.org/assets/bootstrap/css/bootstrap.min.css" rel="stylesheet"> | |
| 10 <link rel="stylesheet" href="http://www.simplyhtml.org/assets/font-awesome/css/font-awesome.min.css"> | |
| 11 <script src="http://www.simplyhtml.org/assets/jquery/jquery.min.js"></script> | |
| 12 | |
| 13 <link href="http://www.simplyhtml.org/assets/simplyhtml/simplyhtml.css" rel="stylesheet"/> | |
| 14 <script src="http://www.simplyhtml.org/assets/simplyhtml/simplyhtml.js"></script> | |
| 15 </head> | |
| 16 <body> | |
| 17 <div container> | |
| 18 <h1>How Luan differs from Lua</h1> | |
| 19 | |
| 20 <p>This document explains how <a href="/">Luan</a> differs from <a href="http://www.lua.org">Lua</a> as described in the <a href="http://www.lua.org/manual/5.3/">Lua 5.3 Reference Manual</a>.</p> | |
| 21 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
22 <h2 margin-top="1em">Contents</h2> |
| 353 | 23 |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
24 <div margin-bottom="1em"><a href="#intro">Introduction</a></div> |
| 353 | 25 |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
26 <div margin-bottom="1em"> |
| 353 | 27 <a href="#basic">Basic Concepts</a> |
| 28 <ul> | |
| 29 <li><a href="#types">Values and Types</a></li> | |
| 30 <li><a href="#env">Environments</a></li> | |
| 31 <li><a href="#error">Error Handling</a></li> | |
| 32 <li><a href="#meta">Metatables and Metamethods</a></li> | |
| 33 <li><a href="#gc">Garbage Collection</a></li> | |
| 34 <li><a href="#coroutines">Coroutines</a></li> | |
| 35 </ul> | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
36 </div> |
| 353 | 37 |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
38 <div margin-bottom="1em"> |
| 353 | 39 <a href="#lang">The Language</a> |
| 40 <ul> | |
| 41 <li><a href="#lex">Lexical Conventions</a></li> | |
| 42 <li> | |
| 43 <a href="#stmt">Statements</a> | |
| 44 <ul> | |
| 45 <li><a href="#control">Control Structures</a></li> | |
| 46 <li><a href="#for">For Statement</a></li> | |
| 47 <li><a href="#logical">Logical Statements</a></li> | |
| 367 | 48 <li><a href="#template-stmt">Template Statements</a></li> |
| 49 </ul> | |
| 50 </li> | |
| 51 <li> | |
| 52 <a href="#expr">Expressions</a> | |
| 53 <ul> | |
| 54 <li><a href="#bit">Bitwise Operators</a></li> | |
| 55 <li><a href="#local-ops">Logical Operators</a></li> | |
| 56 <li><a href="#fn-call">Function Calls</a></li> | |
| 57 <li><a href="#template-expr">Template Expressions</a></li> | |
| 353 | 58 </ul> |
| 59 </li> | |
| 60 </ul> | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
61 </div> |
| 353 | 62 |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
63 <h2 margin-top="1em"><a name="intro">Introduction</a></h2> |
| 353 | 64 |
| 65 <p>Lua is one of the simplest languages available, but Luan is even simpler. This means Luan removes more than it adds. Most of what is added is added in the library, not in the language itself.</p> | |
| 66 | |
| 67 <p>Luan is implemented in Java and is tightly integrated with Java. This makes it an excellent scripting language for Java.</p> | |
| 68 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
69 <h2 margin-top="1em"><a name="basic">Basic Concepts</a></h2> |
| 353 | 70 |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
71 <h3 margin-top="1em"><a name="types">Values and Types</a></h3> |
| 353 | 72 |
| 73 <p>Luan does not have the Lua <i>thread</i> type. Luan add a <i>binary</i> type that Lua doesn't have. This is because Lua strings can represent binary while Luan strings cannot.</p> | |
| 74 | |
| 75 <p>The Luan <i>Nil</i> type is implemented as the Java <i>null</i>. The Luan <i>Boolean</i> type is implemented as the Java <i>Boolean</i> type. The Luan <i>Number</i> type is implemented as the Java <i>Number</i> type. The Luan <i>String</i> type is implemented as the Java <i>String</i> type. Actual numbers may be any subclass of the Java <i>Number</i> class.</p> | |
| 76 | |
| 77 <p>Luan functions may be written in Luan or may be wrappers around native Java methods. Any Java method may be called as a Luan function.</p> | |
| 78 | |
| 79 <p>Luan <i>userdata</i> is nothing more than a Java object that doesn't fall into one of the other recognized types.</p> | |
| 80 | |
| 81 <p>The Luan <i>binary</i> type is the Java <i>byte[ ]</i> type which is an array of bytes.</p> | |
| 82 | |
| 83 <p>The Luan <i>table</i> type is just like its Lua equivalent, but implemented in Java.</p> | |
| 84 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
85 <h3 margin-top="1em"><a name="env">Environments</a></h3> |
| 353 | 86 |
| 87 <p>Luan has an <tt>_ENV</tt> which is like its Lua equivalent. However Luan has no global environment at all, no <tt>_G</tt>.</p> | |
| 88 | |
| 89 <p>Every module is initialized with two local functions: <tt>require</tt> and <tt>java</tt>. The module then uses these functions to get access to whatever else it needs.</p> | |
| 90 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
91 <h3 margin-top="1em"><a name="error">Error Handling</a></h3> |
| 353 | 92 |
| 93 <p>Luan has the functions <tt>error</tt> and <tt>pcall</tt> but does not have <tt>xpcall</tt>. Luan adds the function <tt>try</tt> which looks and acts like try-catch blocks in other languages.</p> | |
| 94 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
95 <h3 margin-top="1em"><a name="meta">Metatables and Metamethods</a></h3> |
| 353 | 96 |
| 97 <p>to document later...</p> | |
| 98 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
99 <h3 margin-top="1em"><a name="gc">Garbage Collection</a></h3> |
| 353 | 100 |
| 101 <p>Luan uses Java garbage collection. Luan has no special garbage collection methods.</p> | |
| 102 | |
| 103 <p>Luan does not yet have weak tables but this will be added.</p> | |
| 104 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
105 <h3 margin-top="1em"><a name="coroutines">Coroutines</a></h3> |
| 353 | 106 |
| 107 <p>Luan does not have coroutines. Coroutines is a complex concept that isn't needed in a simple language, so it was left out.</p> | |
| 108 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
109 <h2 margin-top="1em"><a name="lang">The Language</a></h2> |
| 353 | 110 |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
111 <h3 margin-top="1em"><a name="lex">Lexical Conventions</a></h3> |
| 353 | 112 |
| 113 <p>Unlike Lua, Luan generally considers the end of a line to be the end of a statement. This catches errors and encourages readability. The exception to this is in paranthesis ( <i>(...)</i>, <i>[...]</i>, and <i>{...}</i> ) where the end of line is treated as white space.</p> | |
| 114 | |
| 115 <p>Luan has exactly the same set of keywords as Lua and has the same other lexical conventions.</p> | |
| 116 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
117 <h3 margin-top="1em"><a name="stmt">Statements</a></h3> |
| 353 | 118 |
| 119 <p>Most statements in Luan are the same as Lua. Only those statements that differ will be listed here.</p> | |
| 120 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
121 <h4 margin-top="1em"><a name="control">Control Structures</a></h4> |
| 353 | 122 |
| 123 <p>The Luan <b>if</b>, <b>while</b>, and <b>repeat</b> statement are the same as in Lua except that the condition expression must return a boolean value. Any other value type will produce an error. This helps catch errors and makes code more readable.</p> | |
| 124 | |
| 125 <p>Luan does not have a <b>goto</b> statement.</p> | |
| 126 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
127 <h4 margin-top="1em"><a name="for">For Statement</a></h4> |
| 353 | 128 |
| 129 <p>Luan has no numeric <b>for</b> statement. Luan only has generic <b>for</b> statement. Instead of the numeric <b>for</b> statement, Luan uses the <tt>range</tt> function in a generic <b>for</b> statement like this:</p> | |
| 130 | |
| 131 <tt><pre> | |
| 132 for i in range(from,to,step) do <i>block</i> end | |
| 133 </pre></tt> | |
| 134 | |
| 135 <p>The Luan generic <b>for</b> statement is simpler than the Lua version because Luan only uses and expression, not an explist. So a <b>for</b> statement like:</p> | |
| 136 | |
| 137 <tt><pre> | |
| 138 for var_1, ···, var_n in exp do block end | |
| 139 </pre></tt> | |
| 140 | |
| 141 <p>is equivalent to the code:</p> | |
| 142 | |
| 143 <tt><pre> | |
| 144 do | |
| 145 local f = exp | |
| 146 while true do | |
| 147 local var_1, ···, var_n = f() | |
| 148 if var_1 == nil then break end | |
| 149 block | |
| 150 end | |
| 151 end | |
| 152 </pre></tt> | |
| 153 | |
|
354
705e4d6c3dbb
improve formatting of diff.html
Franklin Schmidt <fschmidt@gmail.com>
parents:
353
diff
changeset
|
154 <h4 margin-top="1em"><a name="logical">Logical Statements</a></h4> |
| 353 | 155 |
| 156 <p>Unlike Lua, Luan allows <b>or</b> and <b>and</b> expressions to be stand-alone statements. This is useful in cases like this:</p> | |
| 157 | |
| 158 <tt><pre> | |
| 159 x==5 or error "x should be 5" | |
| 160 </pre></tt> | |
| 161 | |
| 367 | 162 <h4 margin-top="1em"><a name="template-stmt">Template Statements</a></h4> |
| 163 | |
| 164 <p>Template statements are based on <a href="#template-expr">template exressions</a> and provide the full equivalent of <a href="http://en.wikipedia.org/wiki/JavaServer_Pages">JSP</a> but in a general way. Template statements write the equivalent template exression to standard output. For example:</p> | |
| 165 | |
| 166 <tt><pre> | |
| 167 local name = "Bob" | |
| 168 %> | |
| 169 Hello <%=name%>! | |
| 170 Bye <%=name%>. | |
| 171 <% | |
| 172 </pre></tt> | |
| 173 | |
| 174 <p>is equivalent to the code:</p> | |
| 175 | |
| 176 <tt><pre> | |
| 177 local name = "Bob" | |
| 178 Io.stdout.write( %> | |
| 179 Hello <%=name%>! | |
| 180 Bye <%=name%>. | |
| 181 <% ) | |
| 182 </pre></tt> | |
| 183 | |
| 184 <h3 margin-top="1em"><a name="expr">Expressions</a></h3> | |
| 185 | |
| 186 <h4 margin-top="1em"><a name="bit">Bitwise Operators</a></h4> | |
| 187 | |
| 188 <p>Bitwise operators appear to be new addition to Lua 5.3 and didn't exist in Lua 5.2. Luan does not support bitwise operators, but these can be added if there is a need.</p> | |
| 189 | |
| 190 <h4 margin-top="1em"><a name="local-ops">Logical Operators</a></h4> | |
| 191 | |
| 192 <p>The only change in Luan is that <b>not</b> must take a boolean argument. This helps catch errors and makes code more readable.</p> | |
| 193 | |
| 194 <h4 margin-top="1em"><a name="fn-call">Function Calls</a></h4> | |
| 195 | |
| 196 <p>Luan does not support Lua's <tt>v:name(args)</tt> style object-oriented function call. Object oriented programming is done in Luan using closures, so this feature is not needed.</p> | |
| 197 | |
| 198 <h4 margin-top="1em"><a name="template-expr">Template Expressions</a></h4> | |
| 199 | |
| 200 <p>Luan adds a new type of expression based on <a href="http://en.wikipedia.org/wiki/JavaServer_Pages">JSP</a> called template expressions. Template expressions return multiple values. Here is an example:</p> | |
| 201 | |
| 202 <tt><pre> | |
| 203 local name = "Bob" | |
| 204 write( %>Hello <%=name%>!<% ) | |
| 205 </pre></tt> | |
| 206 | |
| 207 <p>This template expression returns 3 values: "Hello ", "Bob", and "!". The strings in template expressions may be multiple lines.</p> | |
| 208 | |
| 353 | 209 </div> |
| 210 | |
| 211 <script src="http://www.simplyhtml.org/assets/bootstrap/js/bootstrap.min.js"></script> | |
| 212 </body> | |
| 213 </html> |