grandMA3 User Manual Publication

HandleToStr(handle)

grandMA3 User Manual » Plugins » Lua Functions - Object-Free API » HandleToStr(handle)
Version 2.1

Description

The HandleToStr Lua function converts a handle into a string in a hexadecimal number format.

See the Handle topic for more info regarding handles and links to other related functions.

Arguments

  • Handle:
    The handle of the object.

Return

  • String:
    The returned string is the handle number converted to a hexadecimal format.

Example

This example prints the handle hex number for the selected sequence. It also converts the string back to a handle and uses this to print the name of the sequence:

Lua
return function()
Printf("The string (in hex format with 'H#' in front) for the handle of the selected sequence: %s",HandleToStr(SelectedSequence()))
end