Libx Lua ドキュメント

    このページの内容

    luacコマンド

    名前

    luac - Luaコンパイラー

    書式

    luac [ options ] [ filenames ]

    説明

    luacはLuaコンパイラーです。Luaプログラミング言語で書かれたプログラムを、後から読み込んで実行できるプリコンパイル済みチャンクを含むバイナリファイルへ変換します。

    チャンクをプリコンパイルする主な利点は、読み込みの高速化、ユーザーの誤操作によるソースコード変更からの保護、オフラインでの構文検査です。Luaではチャンクは実行前に必ずバイトコードへコンパイルされるため、プリコンパイルしても実行が速くなるとは限りません。luacは、そのバイトコードを後で実行するためにファイルへ保存できるようにするだけです。プリコンパイル済みチャンクは、対応するソースより小さいとは限りません。プリコンパイルの主な目的は読み込みの高速化です。

    コマンドラインでは、Luaソースを含むテキストファイルとプリコンパイル済みチャンクを含むバイナリファイルを混在させられます。luacは、指定されたすべてのファイルを結合したバイトコードを含む単一の出力ファイルを生成します。結合ファイルの実行は、指定されたファイルを実行することと等価です。デフォルトでは出力ファイル名はluac.outですが、-oオプションで変更できます。

    プリコンパイル済みチャンクには、異なるアーキテクチャー間の移植性がありません。さらに、Luaの新しいバージョンが公開されると、プリコンパイル済みチャンクの内部形式が変更される可能性があります。プリコンパイルしたすべてのLuaプログラムについて、必ずソースファイルを保存してください。

    オプション

    -l

    Lua仮想マシン向けにコンパイルされたバイトコードの一覧を生成します。バイトコードの一覧はLua仮想マシンについて学ぶのに役立ちます。ファイルを指定しない場合、luacはluac.outを読み込み、その内容を一覧表示します。完全な一覧には**-l** -lを使います。

    -o file

    デフォルトのluac.outではなく、fileへ出力します。（標準出力には**’-‘**を使用できますが、標準出力をテキストモードで開くプラットフォームでは使用できません。）すべてのファイルは出力ファイルを書き込む前に読み込まれるため、出力ファイルを指定したファイルのいずれかにすることもできます。重要なファイルを上書きしないよう注意してください。

    -p

    ファイルを読み込みますが、出力ファイルは生成しません。主に構文検査とプリコンパイル済みチャンクのテストに使います。破損したファイルは、読み込み時にエラーを発生させる可能性があります。ファイルを指定しない場合、luacはluac.outを読み込み、その内容をテストします。ファイルがエラーなく読み込まれた場合、メッセージは表示されません。

    -s

    出力ファイルを書き込む前にデバッグ情報を除去します。非常に大きなチャンクでは容量を節約できますが、除去したチャンクの実行時にエラーが起きると、通常含まれる完全な情報がエラーメッセージに含まれない場合があります。特に、行番号とローカル変数名が失われます。

    -v

    バージョン情報を表示します。

    —

    オプションの処理を停止します。

    -

    オプションの処理を停止し、標準入力を処理します。

    関連項目

    lua (1)

    lua.orgのドキュメント。

    診断

    エラーメッセージは自己説明的であるべきです。

    著者

    R. Ierusalimschy、L. H. de Figueiredo、W. Celes