Dump (handle)

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

説明

The Dump function returns a string with information about the object, for instance, the name, class, path of the object, its properties, and children.

引数

  • handle:
    The function takes a handle of the type "light_userdata" as an argument.
    It can be omitted when using the colon notation for object-oriented calls.

    The Colon Notation is a way to omit the handle as the first argument when using the Object functions.

    This is the general syntax with the colon notation: object:function()

    This is the general syntax with standard handle notation: object.function(object)

    Learn more in the Lua Functions - Object API topic.

戻り値

The function returns nothing but outputs information about the object in the Command Line History window.

These examples all print information about the selected sequence in the Command Line History.

The first example using the colon operator:

Lua
return function ()
-- Dump() is called on a function
Printf("=============== START OF DUMP ===============")
SelectedSequence():Dump()
Printf("================ END OF DUMP ================")
end

 The second example uses a variable with the same result:

Lua
return function ()
--Stores the handle for the selected sequence in a local variable.
local mySeqHandle = SelectedSequence()
-- Dump() is called on the variable.
Printf("=============== START OF DUMP ===============")
mySeqHandle:Dump()
Printf("================ END OF DUMP ================")
end