Description
|
Retrieves the name of an object based on its handle. See also sim.setObjectName.
|
C synopsis
|
simChar* simGetObjectName(simInt objectHandle)
|
C parameters |
objectHandle: handle of the object. By adding sim.handleflag_altname to the object handle, the object alternative name can be retrieved.
|
C return value
|
Name (or alternative name) of the object if operation was successful, NULL otherwise. The user is in charge of destroying the returned buffer with simReleaseBuffer
|
Lua synopsis
|
string objectName=sim.getObjectName(number objectHandle) |
Lua parameters |
Same as C-function
|
Lua return values
|
Same as C-function (but nil instead of NULL, and simReleaseBuffer does not need to be called)
|
Remote API equiv.
|
Legacy remote API: -
|