Lua教程(四):在Lua中调用C语言、C++的函数
本教程将介绍如何在Lua里面调用c/c++函数。
在Lua里面调用c/c++函数其实是比较简单,本文将通过两个示例演示具体的做法:一个是求平均数,另一个是打印lua函数的一些参数信息。
最后,本文会介绍如何把这两个函数定义成一个模块,这样lua代码里面就可以不再使用全局的名字空间了。
前言
当我们需要在Lua里面调用c/c++函数时,所有的函数都必须满足以下函数签名:
typedefint(*lua_CFunction)(lua_State*L);
换句话说,所有的函数必须接收一个lua_State作为参数,同时返回一个整数值。因为这个函数使用Lua栈作为参数,所以它可以从栈里面读取任意数量和任意类型的参数。而这个函数的返回值则表示函数返回时有多少返回值被压入Lua栈。(因为Lua的函数是可以返回多个值的)
示例一
定义C++函数指针
intaverage(lua_State*L)
{
//getnumberofarguments
intn=lua_gettop(L);
doublesum=0;
inti;
//loopthrougheachargument
for(i=1;i<=n;i++)
{
//totalthearguments
sum+=lua_tonumber(L,i);
}
//pushtheaverage
lua_pushnumber(L,sum/n);
//pushthesum
lua_pushnumber(L,sum);
//returnthenumberofresults
return2;
}
注册此函数给Lua
lua_register(L,"average",average);
Lua里面调用此函数
avg,sum=average(10,20,30,40,50)
print("Theaverageis",avg)
print("Thesumis",sum)
示例二
定义C++函数
intdisplayLuaFunction(lua_State*l)
{
//numberofinputarguments
intargc=lua_gettop(l);
//printinputarguments
std::cout<<"[C++]FunctioncalledfromLuawith"<<argc
<<"inputarguments"<<std::endl;
for(inti=0;i<argc;i++)
{
std::cout<<"inputargument#"<<argc-i<<":"
<<lua_tostring(l,lua_gettop(l))<<std::endl;
lua_pop(l,1);
}
//pushtothestackthemultiplereturnvalues
std::cout<<"[C++]Returningsomevalues"<<std::endl;
lua_pushnumber(l,12);
lua_pushstring(l,"Seeyouspacecowboy");
//numberofreturnvalues
return2;
}
注册此Lua函数
//pushtheC++functiontobecalledfromLua std::cout<<"[C++]PushingtheC++function"<<std::endl; lua_pushcfunction(L,displayLuaFunction); lua_setglobal(L,"displayLuaFunction");
注意,上一个示例,我们使用的是函数是
lua_register(L,"average",average);
它其实只是一个宏定义,其实现也是上面两个函数组成的。
在Lua里调用此函数
io.write('[Lua]CallingtheCfunctionn')
a,b=displayLuaFunction(12,3.141592,'hola')
--printthereturnvalues
io.write('[Lua]TheCfunctionreturned<'..a..'>and<'..b..'>\n')
实现一个Lua模块
首先,我们把这两个C函数封装到一个数组里面:
staticconstluaL_Regmylibs[]=
{
{"average",average},
{"displayLuaFunction",displayLuaFunction},
{NULL,NULL}
};
接下来,我们定义另一个C函数,让它注册我们的Lua模块:
intlua_openmylib(lua_State*L)
{
luaL_newlib(L,mylibs);
return1;
};
这里的luaL_newlib会生成一个table,并把所有的mylibs里面的函数填充进去。最后,lua_openmylib返回值为1,表示会把刚刚生成的table压入栈。
最后,我们像之前注册Lua的标准库一样,注册我们新的库,并给它起名字为mylib:
staticconstluaL_Reglualibs[]=
{
{"base",luaopen_base},
{"io",luaopen_io},
{"mylib",lua_openmylib},
{NULL,NULL}
};
此时,我们在Lua里面调用之前的两个函数就需要带上模块名字前缀了:
avg,sum=mylib.average(10,20,30,40,50) a,b=mylib.displayLuaFunction(12,3.141592,'hola')
结语
注意:这里C函数参数里的Lua栈是私有的,每一个函数都有自己的栈。当一个c/c++函数把返回值压入Lua栈以后,该栈会自动被清空。