forked from cloudwu/lua53doc
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathindex.html
346 lines (299 loc) · 10.6 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Lua 5.3 readme</TITLE>
<LINK REL="stylesheet" TYPE="text/css" HREF="lua.css">
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=utf-8">
<STYLE TYPE="text/css">
blockquote, .display {
border: solid #a0a0a0 2px ;
padding: 1em ;
margin: 0px ;
border-radius: 8px ;
}
.display {
word-spacing: 0.25em ;
}
dl.display dd {
padding-bottom: 0.2em ;
}
tt, kbd, code {
font-size: 12pt ;
}
</STYLE>
</HEAD>
<BODY>
<HR>
<H1>
<A HREF="http://www.lua.org/"><IMG SRC="logo.gif" ALT="Lua" BORDER=0></A>
Lua 5.3.0 欢迎你
</H1>
<P>
<A HREF="#about">关于</A>
·
<A HREF="#install">安装</A>
·
<A HREF="#changes">变更</A>
·
<A HREF="#license">许可证</A>
·
<A HREF="contents.html">参考手册</A>
·
<A HREF="term.html">中英术语对照表</A>
<H2><A NAME="about">关于 Lua</A></H2>
<P>
Lua 是一门强大、快速、轻量的嵌入式脚本语言。它由巴西里约热内卢 Pontifical Catholic 大学的
<A HREF="http://www.puc-rio.br/">PUC-Rio</A>
<A HREF="http://www.lua.org/authors.html">团队</A>
开发。
Lua 是一个
<A HREF="#license">自由软件</A>，
它在全世界范围内广泛用于很多产品和项目。
<P>
Lua 的
<A HREF="http://www.lua.org/">官方网站</A>
上有关于 Lua 的完整信息，
其中包括
<A HREF="http://www.lua.org/about.html">综合概要</A>
以及最新版的
<A HREF="http://www.lua.org/docs.html">文档</A>，
需要注意的是
<A HREF="http://www.lua.org/manual/5.3/">参考手册</A> 可能和
<A HREF="contents.html">这里的版本</A> 有所不同。
<H2><A NAME="install">安装 Lua</A></H2>
<P>
Lua 是以
<A HREF="http://www.lua.org/ftp/">源代码</A>
的形式发布的。
在使用前，你需要自己构建它。
构建 Lua 非常简单，因为 Lua 是用纯粹的 ANSI C 实现的，在所有有 ANSI C 编译器的平台都可以直接编译。
同时，Lua 还可以直接以 C++ 形式编译。
下面介绍了类 Unix 平台上的构建流程，另有
<A HREF="#other">其它系统构建介绍</A>
与
<A HREF="#customization">配置选项</A> 以作参考。
<P>
如果你没有时间或兴趣自己编译 Lua ，
可以从
<A HREF="http://lua-users.org/wiki/LuaBinaries">LuaBinaries</A> 获取编译后的二进制文件，
或者从
<A HREF="http://luadist.org/">LuaDist</A> 这里获取 Lua 的多平台发布版（自带电池）。
<H3>构建 Lua</H3>
<P>
对于大多数类 Unix 平台，只需要输入 "<KBD>make</KBD>" 加上合适的平台名即可。细节如下：
<OL>
<LI>
打开一个控制台窗口，切换到名为 <TT>lua-5.3.0</TT> 的目录下。
这里有一个 <TT>Makefile</TT> 文件内含构建及安装流程。
<P>
<LI>
运行 "<KBD>make</KBD>" 看看你的平台是否列在其中。
当前支持的平台有：
<P>
<P CLASS="display">
aix bsd c89 freebsd generic linux macosx mingw posix solaris
</P>
<P>
如果你的平台列在其中，那么只需要运行 "<KBD>make xxx</KBD>"，这里的 xxx
指你的平台名。
<P>
如果你的平台不在这个列表内，那么先试一下最接近的那个，然后再按 posix generic c89 这个次序依次尝试。
<P>
<LI>
编译流程要花一会儿功夫，最终在 <TT>src</TT> 目录产生三个文件：
lua (解释器),
luac (编译器),
以及 liblua.a (静态库) 。
<P>
<LI>
你可以运行 "<KBD>make test</KBD>" 检查一下构建是否成功，
它会运行解释器打印出版本号。
</OL>
<P>
如果你是 Linux 系统，出现了编译错误的话，请确认你有安装
<TT>readline</TT> 开发包。
如果还是有链接错误，可以试一下
"<KBD>make linux MYLIBS=-ltermcap</KBD>" 。
<H3>安装 Lua</H3>
<P>
一旦你构建完毕，可能希望把 Lua 安装到系统默认位置。
那么，执行 "<KBD>make install</KBD>" 就可以了。
系统默认位置以及如何安装都定义在 <TT>Makefile</TT> 中。
这个过程可能需要有相关的权限。
<P>
运行 "<KBD>make xxx install</KBD>" 可以构建和安装一步到位，
这里的 xxx 指你的平台名。
<P>
如果你想把 Lua 安装在本地，运行 "<KBD>make local</KBD>"。
它会创建一个 <TT>install</TT> 目录，内有
<TT>bin</TT>, <TT>include</TT>, <TT>lib</TT>, <TT>man</TT>, <TT>share</TT>,
子目录，并将下列文件安装在其中。
如果你想安装到本地其它目录，
运行 "<KBD>make install INSTALL_TOP=xxx</KBD>"，这里的 xxx 指你选择的目录。
由于安装过程中会切换到 <TT>src</TT> 以及 <TT>doc</TT> 目录进行，
所以当 <TT>INSTALL_TOP</TT> 不是绝对路径时务必小心。
<DL CLASS="display">
<DT>
bin:
<DD>
lua luac
<DT>
include:
<DD>
lauxlib.h lua.h lua.hpp luaconf.h lualib.h
<DT>
lib:
<DD>
liblua.a
<DT>
man/man1:
<DD>
lua.1 luac.1
</DL>
<P>
这些是开发时需要的目录。
如果你仅仅想运行一些 Lua 程序，
那么只需要 <TT>bin</TT> 和 <TT>man</TT> 下的文件。
<TT>include</TT> 和 <TT>lib</TT> 下的文件用于将 Lua 嵌入
C 或 C++ 程序。
<H3><A NAME="customization">定制</A></H3>
<P>
有三类定制，可以通过编辑文件完成：
<UL>
<LI> 怎样安装 Lua 以及安装到哪里 — 编辑 <TT>Makefile</TT>。
<LI> 怎样构建 Lua — 编辑 <TT>src/Makefile</TT>。
<LI> Lua 特性 — 编辑 <TT>src/luaconf.h</TT>。
</UL>
<P>
其实你不必编辑 Makefile 文件，make 的时候在命令行指定相关变量即可。
当然，编辑保存 Makefile 可以给定制留个记录。
<P>
另一方面，如果你需要定制一些 Lua 特性，那就需要在构建安装 Lua 前
编辑 <TT>src/luaconf.h</TT> 。
编辑过的文件必须确保一致性，也就是只安装在一个地方，
让所有你编译出来的用到 Lua 的程序都使用这唯一的这一份。
专家可以通过编辑 Lua 源代码来定制更多的东西。
<H3><A NAME="other">在其它系统上构建 Lua</A></H3>
<P>
如果你不使用常规的 Unix 工具，那么构建 Lua 的流程就取决于你使用的编译器。
你需要创建若干工程来构建库，解释器以及编译器等。请把下列源文件加入相关工程：
<DL CLASS="display">
<DT>
库:
<DD>
lapi.c lcode.c lctype.c ldebug.c ldo.c ldump.c lfunc.c lgc.c llex.c
lmem.c lobject.c lopcodes.c lparser.c lstate.c lstring.c ltable.c
ltm.c lundump.c lvm.c lzio.c
lauxlib.c lbaselib.c lbitlib.c lcorolib.c ldblib.c liolib.c
lmathlib.c loslib.c lstrlib.c ltablib.c lutf8lib.c loadlib.c linit.c
<DT>
解释器:
<DD>
library, lua.c
<DT>
编译器:
<DD>
library, luac.c
</DL>
<P>
把 Lua 以一个库形式用于你的程序，你需要知道如何用你的编译器创建库和使用库。
比如，以动态加载的 C 库形式使用 Lua，你需要了解如何创建动态库并让 Lua API 函数
在动态库中可见 — <EM>不要</EM> 将 Lua 库链入每个动态库。
在 Unix 下，我们建议把 Lua 库静态链入宿主程序，然后将符号导出用于动态链接；
<TT>src/Makefile</TT> 就是这样处理 Lua 解释器的。
在 Windows 下，我们建议把 Lua 库编译成一个 DLL 。
无论怎样，编译器 luac 都应该静态链接。
<P>
正如上面所述，你可以在构建 Lua 前编辑 <TT>src/luaconf.h</TT>
以定制一些特性。
<H2><A NAME="changes">自 Lua 5.2 以来的变更</A></H2>
<P>
这里列出了 Lua 5.3 引入的主要变更。
<A HREF="contents.html">参考手册</A>
中列出了
<A HREF="manual.html#8">不兼容的地方</A>。
<H3>主要变化</H3>
<UL>
<LI> 整数 (默认 64 位)
<LI> 32 位整数的官方支持
<LI> 位操作符
<LI> 基本的 utf-8 支持
<LI> 值的打包及解包函数
</UL>
这些是 Lua 5.3 引入的其它变更：
<H3>语言</H3>
<UL>
<LI> 用户数据可以是任意 Lua 值
<LI> 整数除法
<LI> 某些元方法有了更加灵活的规则
</UL>
<H3>库</H3>
<UL>
<LI> <CODE>ipairs</CODE> 以及表处理库都会考虑元方法
<LI> <CODE>string.dump</CODE> 多了裁减选项
<LI> 表处理库考虑了元方法
<LI> 新函数 <CODE>table.move</CODE>
<LI> 新函数 <CODE>string.pack</CODE>
<LI> 新函数 <CODE>string.unpack</CODE>
<LI> 新函数 <CODE>string.packsize</CODE>
</UL>
<H3>C API</H3>
<UL>
<LI> 简化了延续点 API
<LI> <CODE>lua_gettable</CODE> 以及类似函数会返回结果的值类型
<LI> <CODE>lua_dump</CODE> 增加了裁减选项
<LI> 新函数： <CODE>lua_geti</CODE>
<LI> 新函数： <CODE>lua_seti</CODE>
<LI> 新函数： <CODE>lua_isyieldable</CODE>
<LI> 新函数： <CODE>lua_numbertointeger</CODE>
<LI> 新函数： <CODE>lua_rotate</CODE>
<LI> 新函数： <CODE>lua_stringtonumber</CODE>
</UL>
<H3>Lua 独立解释器</H3>
<UL>
<LI> 可以做计算器使用；不再需要前置 '='
<LI> <CODE>arg</CODE> 表对所有代码都可用
</UL>
<H2><A NAME="license">License</A></H2>
<A HREF="http://www.opensource.org/docs/definition.php">
<IMG SRC="osi-certified-72x60.png" ALIGN="right" BORDER="0" ALT="[osi certified]" STYLE="padding-left: 30px ;">
</A>
<P>
Lua is free software distributed under the terms of the
<A HREF="http://www.opensource.org/licenses/mit-license.html">MIT license</A>
reproduced below;
it may be used for any purpose, including commercial purposes,
at absolutely no cost without having to ask us.
The only requirement is that if you do use Lua,
then you should give us credit by including the appropriate copyright notice somewhere in your product or its documentation.
For details, see
<A HREF="http://www.lua.org/license.html">this</A>.
<BLOCKQUOTE STYLE="padding-bottom: 0em">
Copyright © 1994–2015 Lua.org, PUC-Rio.
<P>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
<P>
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
<P>
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
</BLOCKQUOTE>
<P>
<HR>
<SMALL CLASS="footer">
最后修改时间:
2015年1月13日15:16
</SMALL>
</BODY>
</HTML>