ToAddr(handle)

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object API » ToAddr(handle)

Version 2.0

説明

ToAddr 関数は、ハンドルを、コマンドで使用できるアドレス文字列に変換します。

ハンドルの詳細や関連関数については、ハンドルを参照してください。

引数

handle:
"light_userdata" 型のハンドルです。オブジェクトでコロン記法を用いる場合は省略できます(後述の例を参照)。

戻り値

Address:
アドレス値を表す文字列を返します。

例

以下の2つの例は、選択されているデータプールにある最初のシーケンスのアドレスを取得し、その前に "Go" キーワードを付けて grandMA3 コマンドを作成します。このコマンドは grandMA3 のコマンドラインに送られます。

コロン記法による例です。

Copy Code

Lua

return function()
    -- Stores the handle in a variable.
    local mySequence = DataPool().Sequences[1]
    -- Converts the handle to the address and store in variable.
    local mySequenceAddress = mySequence:ToAddr()
    -- Send a 'Go' command with the address appended.
    Cmd("Go %s", mySequenceAddress)
end

引数としてハンドルを指定しても同じ結果になります。

Copy Code

Lua

return function()
    -- Stores the handle in a variable.
    local mySequence = DataPool().Sequences[1]
    -- Converts the handle to the address and store in variable.
    local mySequenceAddress = ToAddr(mySequence)
    -- Send a go command with the address appended.
    Cmd("Go %s", mySequenceAddress)
end