CからのLua関数呼び出し
CコードからLuaスクリプトと関数を読み込み、実行します。
「CからのLua関数呼び出し」はCoddyKit上の無料Lua Academyレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはLua Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Lua Academyコースには全4レッスンが含まれています。
概要
CからLua関数を呼び出すには、関数をpushし、引数をpushし、lua_pcallを呼び出してから、スタックから結果を読み取ります。
Luaスクリプトの読み込み
luaL_dofile(L, filename)はLuaファイルを読み込んで実行します。または、読み込みと呼び出しを分けるためにluaL_loadfileとlua_pcallを組み合わせて使用します。
// C code
if (luaL_dofile(L, "config.lua") != LUA_OK) {
fprintf(stderr, "Error: %s\n", lua_tostring(L, -1));
lua_pop(L, 1);
}グローバル関数の取得
lua_getglobal(L, "funcName")を使うと、Luaのグローバル関数をスタックへpushできます。
// C code
lua_getglobal(L, "myFunction"); // push function
lua_pushnumber(L, 10); // push arg1
lua_pushnumber(L, 20); // push arg2lua_pcall
lua_pcall(L, nargs, nresults, errfunc)はスタック上の関数を呼び出します。成功するとLUA_OKを返し、結果をスタックに残します。
// C code
if (lua_pcall(L, 2, 1, 0) != LUA_OK) {
fprintf(stderr, "Call error: %s\n", lua_tostring(L, -1));
lua_pop(L, 1);
} else {
double result = lua_tonumber(L, -1);
lua_pop(L, 1);
printf("Result: %f\n", result);
}複数の戻り値
lua_pcallのnresultsで、読み取る戻り値の数を指定します。戻り値は順番どおりにスタックへpushされます。
// C: calling a Lua fn that returns two values
lua_getglobal(L, "minmax");
lua_pushnumber(L, 5); lua_pushnumber(L, 3);
lua_pcall(L, 2, 2, 0);
double mn = lua_tonumber(L, -2);
double mx = lua_tonumber(L, -1);
lua_pop(L, 2);LUA_MULTRET
LUA_MULTRETをnresultsとして渡すと、関数から返されるすべての戻り値を受け取れます。その後、lua_gettop(L)で返された値の個数を確認してください。
エラーハンドラー
独自のエラーハンドラーを使うには、lua_pcallに0以外のerrfuncを渡します。ハンドラーはエラーオブジェクトを受け取り、トレースバック情報を追加できます。
// C: setup traceback handler
lua_getglobal(L, "debug");
lua_getfield(L, -1, "traceback");
lua_remove(L, -2); // remove debug table
int errhandler = lua_gettop(L);
// push fn and args, then:
lua_pcall(L, nargs, nresults, errhandler);オブジェクトのメソッド呼び出し
Luaオブジェクトのメソッドを呼び出すには、メソッド、オブジェクト（self）、その他の引数の順にpushしてから呼び出します。
テーブルを引数として渡す
lua_newtableでスタック上にテーブルを作成し、lua_setfieldでフィールドを設定してから、関数の引数として渡します。
参照レジストリ
luaL_ref(L, LUA_REGISTRYINDEX)を使うと、Luaの値をレジストリに保存し、後で取得するための整数キーを得られます。
// C: store a callback for later use
lua_pushvalue(L, callbackIdx);
int ref = luaL_ref(L, LUA_REGISTRYINDEX);
// Later: lua_rawgeti(L, LUA_REGISTRYINDEX, ref);クリーンアップ
使用しないスタック上の値は必ずpopしてください。不整合なスタックは呼び出しのたびに蓄積し、最終的にオーバーフローします。デバッグビルドではスタックサイズを確認してください。
lua_pcallに関する質問
lua_pcall(L, 2, 1, 0)は何を行いますか？
復習：CからLuaを呼び出す
関数と引数をpushし、lua_pcallを呼び出し、戻りコードを確認してから、スタックから結果を読み取ります。後で使うLuaコールバックの保存にはluaL_refを使用します。使用しないスタック上の値は必ずpopしてください。
よくある質問
「CからのLua関数呼び出し」レッスンは無料ですか？
はい。「CからのLua関数呼び出し」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Lua Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Lua Academyコースには全4レッスンが含まれています。
「CからのLua関数呼び出し」で何を学びますか？
CコードからLuaスクリプトと関数を読み込み、実行します。 ブラウザで直接実行するハンズオンコードでLua Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Lua Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのLua Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。
「CからのLua関数呼び出し」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このLua Academyレッスンでコードを書いて実行できますか？
はい。すべてのLua Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- Lua C APIのスタックモデル
- CからのLua関数呼び出し
- LuaへのC関数の登録
- 状態管理とエラー処理