8 – 以前のバージョンとの非互換性
ここでは、プログラムをLua 5.4からLua 5.5へ移行するときに遭遇する可能性のある非互換性を列挙します。
適切なオプション（ファイルluaconf.hを参照）を指定してLuaをコンパイルすれば、一部の非互換性を回避できます。ただし、これらの互換性オプションは将来すべて削除されます。互換性の問題は、そのオプションが削除されたときに生じることが少なくありません。そのため、機会があるときは、すべての互換性オプションを無効にしてコンパイルしたLuaでコードをテストしてください。これにより、新しいLuaバージョンへの移行が容易になります。
Luaの各バージョンでは、定数の数値や関数のマクロ実装など、プログラムのソースコード変更を伴わない形でC APIが変更される可能性があります。したがって、異なるLuaバージョン間でバイナリ互換性があると仮定してはいけません。新しいバージョンを使うときは、Lua APIのクライアントを必ず再コンパイルしてください。
同様に、プリコンパイル済みチャンクの内部表現はLuaの各バージョンで変更される可能性があります。プリコンパイル済みチャンクには異なるLuaバージョン間の互換性がありません。
公式配布物の標準パスは、バージョン間で変更される可能性があります。
8.1 – 言語の非互換性
-
単語
global
は予約語です。通常の名前として使わないでください。
コンパイルオプション
LUA_COMPAT_GLOBAL（luaconf.hを参照）はglobalを通常の単語にします。 -
for
ループの制御変数は読み取り専用です。変更する必要がある場合は、ループ本体で同じ名前のローカル変数を宣言してください。
-
__callメタメソッドの連鎖は最大15オブジェクトです。
-
エラーでは、エラーオブジェクトが
nil
の場合、文字列メッセージに置き換えられます。
8.2 – ライブラリの非互換性
-
ガベージコレクションの引数は、オプション”
incremental“と”
generational“では設定しません。代わりに、この目的のための新しいオプション”
param“があります。さらに、引数自体にもいくつかの変更があります。
8.3 – APIの非互換性
-
と関連関数では、要求する結果数（
nresults）の最大値は250です。さらに大きな値が本当に必要なら、
を使い、その後でスタックサイズを調整してください。以前、この制限は規定されていませんでした。
-
には第3引数として、文字列ハッシュ用のシードがあります。
-
関数
lua_resetthreadは非推奨です。これは
の
fromを
NULLとしたものと等価です。
-
関数
lua_setcstacklimitは非推奨です。この関数の呼び出しは単純に削除できます。
-
関数
は、writer関数の呼び出しを通じてスタックを保持する方法が変更されました。（以前のバージョンでは規定されていませんでした。）また、ダンプの終了を通知するためにwriter関数をもう一度呼び出します。
-
ガベージコレクションの引数は、オプション
と
では設定しません。代わりに、この目的のための新しいオプション
があります。さらに、引数自体にもいくつかの変更があります。
-
関数
は、エラーを発生させる代わりに報告するようになりました。