lua C api
PS:这里是默认我已经学完了lua脚本的基本知识（包括table，元表，函数，基本库， 文件io，库导入等等）
lua是c写的，无论是lua调用c还是c调用lua都非常容易，以下是基于文档做的一些学习笔记，在文档的索引可以快速找到api的名称方便参考，文档地址如下：
官网5.3文档：http://www.lua.org/manual/5.3/#index
中文文档：http://www.runoob.com/manual/lua53doc/contents.html#index
文档包括两部分，一部分是介绍lua的语法，以及一些注（keng）意(die)事项,比如其中说到空字符串和0都被认为是true，恩，要注意（MDZZ），感觉lua的强大之处在于他的table（手动咸鱼），下面开始修仙，下面通过问答的方式给自己学习lua做一些笔记，在此之前，先编译lua，我们到官网可以下载lua的源码
源码下载页面:http://www.lua.org/download.html
5.3源码下载：http://www.lua.org/ftp/lua-5.3.4.tar.gz
lua源码非常小，很容易编译，windows下，装个Mingw即可用make编译，以下是linux的
1.下载解压源码
wget http://www.lua.org/ftp/lua-5.3.4.tar.gz
tar -xzvf lua-5.3.4.tar.gz
~/local/lua/lua-5.3.4$ make
Please do 'make PLATFORM' where PLATFORM is one of these:
aix bsd c89 freebsd generic linux macosx mingw posix solaris
See doc/readme.html for complete instructions.
上面提示指定编译选项，如果是windows下用Mingw的，就make -j12 mingw, -j12是多线程编译，分12个线程编译，现在是debian，可以选择posix，如果提示缺少一些库，使用apt-get 安装即可
make -j12 posix
编译成功后，在src文件生成一个lua(lua解释器),luac（lua脚本编译器），以及静态库liblua.a,c调用lua的时候，现在是用静态库，现在把以下文件复制到项目目录下
头文件:lua.h lualib.h lauxlib.h luaconf.h
静态库文件:liblua.a
我的项目目录为:~/project/lua
我把头文件放置在~/project/lua/include
静态库文件放在~/project/lua/lib
以下所有的操作都是在项目目录(用$PRO_HOME描述这个目录)
1.c是如何调用lua写的代码的？
1.首先了解，lua在c代码中是如何“工作”的，在c中要调用lua，首先我得创建一个lua状态机（lua_State）
文件$PRO_HOME/main.c
#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"
int main(void)
{
//创建一个lua状态机
lua_State *L = luaL_newstate();
//销毁这货
lua_close(L);
return 0;
}
然后尝试编译这个源文件
$gcc -I ../include -c main.c
$gcc -lm -o main main.o ../lib/liblua.a
编译成功说明配置没有问题
c调用lua代码，首先要学会怎么把lua代码“翻译”成c的代码，先不着急如何把lua代码加载到lua状态机运行，先了解下它是怎么运行的，根据文档参考，写以下一段代码
-- a是一个全局变量
a="测试"
print(a)
a是一个全局变量，在lua中，无非在维护一个堆栈stack和一个环境表_G（暂时理解）
那么用c怎么写呢？
1.创建一个状态机（lua_State），加载基本库(luaL_openlibs())
2.把字符串“测试”压入堆栈(lua_pushstring)
3.把这个字符串弹出，设置为global，名称为a(lua_setglobal())
4.从全局变量中，把print函数压栈（lua_getglobal()）
5.把参数a从全局变量中压栈(lua_getglobal())
6.调用lua_call执行函数
#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"
int main(void)
{
lua_State *L = luaL_newstate();
//加载基本库（print在其中）
luaL_openlibs(L);
//这里相当于设置全局变量a="测试"
lua_pushstring(L,"测试");
lua_setglobal(L,"a");
//print函数压栈
lua_getglobal(L,"print");
//参数压栈yiban
lua_getglobal(L,"a");
//调用函数,1个参数，0个返回值
lua_call(L,1,0);
lua_close(L);
return 0;
}
小总结:
在lua 的 C api中，
数据类型有:
lua_Integer 整形
lua_Number 默认对应的是C double
lua_Unsigned 无符号整形
字符串、布尔型或者是lua的table之类的，都是不能直接“拿出来”的
如果要操作，设置某某某的变量，可以通过lua_pushxxxx来把对应的数据类型的变量的值压入堆栈，如果，要把变量设置为一个全局变量，就把它设置为global(lua_setglobal())，lua_setglobal会把栈顶的元素弹出，病设置到环境表，详情查看文档，
关于堆栈
lua的堆栈是lua自己实现的一个数据结构，并不是c语言执行时的那个堆栈，这个堆栈，由栈底往栈顶数，元素的序号是1 2 3 4 5...，这是它的绝对索引的方式，还有它支持负索引，也就是参考点是栈顶，而不是栈底，比如-1代表的是栈顶的元素，-2代表栈顶的下一个元素
对于堆栈的操作有：
1.获取栈顶的索引值,lua_gettop(L)（这个值，可以当做是栈元素个数）
2.把数据压栈（lua_pushxxx，根据压入的数据类型不一样，有对应有一系列的操作函数,例如，lua_pushstring(L,"测试"),把字符串压入，详情看文档lua_pushxxxx），又或者是
3.把堆栈的元素“读取”出来，lua_toxxxx,就可以不弹出堆栈中的数据，把它转换成c的数据类型，例如:lua_tolstring,注意，这个返回值是const类型，也就是说你不能对他进行更改，如果要做其他用途，你需要
把他copy出来
4.更改元素在堆栈中的位置
5.lua有垃圾回收机制GC，一般不用担心内存释放的问题
2.如何在lua状态机中执行一个c写的函数？
刚刚已经学了，如何在c中，“执行”lua，这个print函数他已经实现了，但是我们自己怎么实现一个函数，然后在lua中调用呢？
这个函数可以是
1.lua写的函数
2.c写的可以让lua识别的函数
我们先来搞第二种,程序还是在原来的基础上进行扩充
我们把print换成我们自己实现的一个函数，这个函数在lua里叫print2,它比较简单，只能接受一个参数，不做任何检查，也不做任何的错误的处理
lua注册的函数的类型是:
static int fun(lua_State *L);
返回值是这个函数的返回值个数（因为lua支持多个返回值，执行完毕后，把返回值依次压栈，然后返回返回值个数就行了），调用结束后，堆栈中剩下的是fun的返回值（如果有返回值，并且按照顺序压栈）
#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"
static int print2(lua_State *L)
{
const char * s = luaL_optlstring (L,1,"啥都没",NULL); //获取函数调用时第1个参数为字符串，如果参数不存在或者是nil就返回“啥都没”，并且把长度放在第四个参数（这里设置为NULL,不获取长度），
printf("这是:%s\n",s);
return 0; //返回值个数为0
}
int main(void)
{
lua_State *L = luaL_newstate();
luaL_openlibs(L); //加载基本库（print在其中）
//这里相当于设置全局变量a=image.png"测试"
lua_pushstring(L,"测试");
lua_setglobal(L,"a");
//注册这个函数到全局表
lua_register(L,"print2",print2);
lua_getglobal(L,"print2"); //把这个函数从全局表中压栈
lua_getglobal(L,"a"); //参数压栈
lua_call(L,1,0); //调用函数,1个参数，0个返回值
lua_close(L); //关闭状态机
return 0;
}
