*Luaライブラリ 要注意点 ～Debugライブラリ～ [#f8545427]

**os.clock [#c80aef1d]
>osライブラリのclockはベンチマークデバッグに利用できるので、osライブラリではなく、あえて、こちらに入れておく。
#sh(lua;){{
local x = os.clock() -- この行に来た瞬間のCPU時間
local s = 0
for i=1, 100000 do
   s = s + i
end
print(string.format("elapsed time: %.2f\n", os.clock()-x ))
}}

- debug.getinfo ([thread,] f [, what])
**debug.getinfo ([thread,] f [, what]) [#rc2199e6]
>関数に関する情報を格納したテーブルを返します。~
f の値として、''関数を直接渡すか、 数値を指定''することができます。~
''数値は指定したスレッドのコールスタック上で実行中のレベル f の関数を表します。~
レベル 0 は現在の関数 (getinfo 自身) で、レベル 1 は getinfo を呼んだ関数で、以下同様です。''~
(スタックにカウントされない末尾呼び出しを除きます)。そうでなければ、date は現在時刻を書式化する。~
format が `!´ で始まっていたら、日付は世界時 (Universal Time) で書式化される。~
このオプション文字の後、 format が *t であれば、 date は以下のフィールドを持つテーブルを返す。~
~

|プロパティ|意味|
|source|関数の定義位置。|
|short_source|sourceの短縮形。(今ひとつ存在意義は謎) |
|linedefined|該当関数が定義されている行|
|lastlinedefined|該当関数が定義されている最後の行|
|what|関数の種類。"Lua"か"C"、メインチャンクの場合は"main"~
debug.getinfo(print).what  --> "C"~
debug.getinfo(myfunc).what  -->"Lua"~
~
i = loadstring("return 3")~
debug.getinfo(i).what  --> "main"~
|what|関数の種類。"Lua"か"C"、メインチャンクの場合は"main"&br;debug.getinfo(print).what  --> "C"&br;debug.getinfo(myfunc).what  -->"Lua"&br;&br;i = loadstring("return 3")&br;debug.getinfo(i).what  --> "main"|
|name|関数の妥当と思われる名前。数値を指定してgetinfoを呼び出した場合のみ機能する。|
|namewhat|nameフィールドの種類。対象の関数が何者か。"global", "local", "method", "field", ""(空文字)|
|nups|関数が持つ上位値の数。レベルと関連。|
|activelines|関数のアクティブ行の集合のテーブル。デバッガでも作らない限り、まぁあまり気にしなくても良い。|
|func|関数自身。|
|これだけだと、一見無意味に思えるが、該当レベルで関数がアクティブだったらここに入るというフィルターがかかっている。|
|func|関数自身。これだけだと、一見無意味に思えるが、該当レベルで関数がアクティブだったらここに入るというフィルターがかかっている。|

#sh(lua;){{
print(os.getenv("PATH"))  --> C:\～～;～～
}}
--埋めるフィールドを指定する文字列 what を指定すると、戻り値のテーブルは lua_getinfo が返すフィールドをすべて持ちます。~
--what のデフォルトは、 有効な行番号のテーブルを除くすべての利用可能な情報を取得します。~
オプション 'f' を指定すると、 func という名前のフィールドにその関数自身を格納します。~
オプション 'L' を指定すると、activelines という名前のフィールドに有効な行番号のテーブルを格納します。
--nameフィールドの取り扱いは、わかりにくい。関数には表面上の表記とは異なり、実質的に名前が無かったり、あるいは、関数に複数の名前がつけられていることがある。~
--Luaはその関数を呼び出したコードから、その関数がどのよううにして呼び出されたかを見て、関数名を検索する。そして、その方法は、数値を指定してgetinfoを呼び出した場合のみうまく機能する。~
--例えば、 式 debug.getinfo(1,"n").name は、 現在の関数の名前 (適当な名前が見つかった場合) を格納したテーブルを返します。~
--また式 debug.getinfo(print) は、 print 関数に関するすべての利用可能な情報を格納したテーブルを返します。

**exit [#y8a52a7a]
>
**debug.getlocal ([thread,] f, local) [#bb9127c8]
>スタック上のレベル f の関数のインデックス local のローカル変数の名前と値を返します。
明示的なローカル変数だけでなく、 引数や一時変数などにもアクセスします。~
~
最初の引数またはローカル変数はインデックス 1 で、 最後のアクティブな変数まで以下同様です。~
負のインデックスを指定すると可変長引数を参照します。~
'-1' は最初の可変長引数です。指定したインデックスの変数が存在しなければ nil を返し、~
範囲外のレベルを指定した場合はエラーを発生します。 (レベルが有効かどうかを調べるには debug.getinfo を使ってください。)~
~
'(' (開き括弧) で始まる変数名は内部の変数 (ループ制御変数、 一時変数、 可変長引数、 および C の関数のローカル変数) を表します。~
~
引数 f に関数を指定することもできます。この場合は関数の引数の名前だけを返します。~
#sh(lua;){{
os.exit ([code])
}}
省略可能な code(整数値) でCの関数 exit を呼んでホストプログラムを終了させる。~
code のデフォルト値は成功を表すコードである。
function foo (a, b)
    local x
  　do local c = a-b end
  　local a = 1
  　while true do
     　 local name, value = debug.getlocal(1,a)
      　if not name then break end
      　print(name, value)
      　a = a + 1
  　end
end

**os.execute [#nf417456]
>外部プログラム実行(他言語のsystem関数系に相当する。コンソール窓が出てしまうので、~
shell.execute関数(コンソールが出ないもの)を別途C層で用意したほうが良い。
foo(10, 20)

**io.popen [#a318ed37]
>osライブラリではないが、os.systemのより便利版として利用できる。いわゆるperlの`(cmd_string)`と同じである。
#sh(lua;){{
for dir in io.popen("dir " .. "C:\\" .. " /b /aa"):lines() do
    print(dir)
end
--[[
  a    10
  b    20
  x    nil
  a    4
]]
}}

**ファイル操作等 [#z4cceac9]
-os.remove (filename) ファイルの削除
>指定された名前のファイルまたはディレクトリを消す。~
対象がディレクトリの場合、ディレクトリ内は空でなければならない。
(※まぁよくあるやつですよ。よって中にあるファイルを消してからディレクトリを消す。~
というのを下層ディレクトリから上層へと再帰的に行う必要がある。)~
この関数が失敗した場合は nil とエラーメッセージを返す。
--まず、関数自体の第1パラメータ、第2パラメータはローカルであるから表示される。~
--xもローカルであるから表示される。~
--cはローカルであるが、それを包むdo～endスコープを抜けると消えるので、debug.getlocalを呼んだ段階では、すでに存在せず、表示対象ではない。~
--name, value はdebug.getlocalを呼んだ段階では、まだ生成されていない。~
--初期化付き変数の場合は、初期化コードの終了後でないと可視とはならない。

-debug.getlocalの第３パラメータ
>debug.getlocalの''第３パラメータには、該当の変数に設定する値を指定''できる。
#sh(lua;){{
sample dir = "..."
　os.remove(dir)
local name, value = debug.getlocal(1, var_index, 5)
}}
~
-os.rename (oldname, newname) ファイル名変更
>ファイル(ディレクトリ)名 oldname を newname にリネームする。~
この関数が失敗した場合は nil とエラーメッセージを返す。~
#sh(lua;){{
f_old = "..."
f_new = "..."
os.rename(f_old, f_new)
}}
とすると、name, varには元の変数の名前と値が返ってくるが、該当の変数の値自体は5になっている。
トップ   一覧 単語検索 最終更新   ヘルプ   最終更新のRSS