AddrNative(handle[, handle[, boolean]])

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

Version 2.0

説明

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

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

引数

handle:
アドレス文字列を取得したいオブジェクトのハンドルです。オブジェクトでコロン記法を用いる場合は省略できます(後述の例を参照)。
This is the handle to the object where the address is requested.
handle (オプション):
デフォルトでは、ルート位置からのアドレスが返されますが、このオプションのハンドルを用いると別のベース位置を指定できます。ルートからオブジェクトへのアドレスパスのベース位置である必要があります。
boolean (オプション):
返される文字列を引用符で囲むには、これを true にします。

戻り値

string:
ドットで区切られた親-子名形式のアドレス文字列を返します。

例

最初のシーケンスのアドレスを出力します。

Copy Code

Lua

return function()
    -- Stores the handle to the first sequence.
    local mySequence = DataPool().Sequences[1]
    -- Print the native address.
    Printf("The full address is: " .. mySequence:AddrNative())
    -- Stores a handle to the default DataPool.
    local myDataPool = DataPool()
    -- Print the native address to the datapool using the default datapool as a base.
    Printf("The address in the datapool is: " .. mySequence:AddrNative(myDataPool))
    -- Print the native address to the datapool, using the default datapool as a base, with names as strings.
    Printf("The address in the datapool with quotes around the names is: " .. mySequence:AddrNative(myDataPool, true))
end