ToAddr(handle)

説明

Lua オブジェクト関数の ToAddr は、ハンドルを、コマンドで使用できるアドレス文字列に変換します。

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

引数

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

戻り値

• address:
  アドレス値を表す文字列。

例

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

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

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

return main

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

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

return main