Regular API function

simRemoveObjects / sim.removeObjects

Description
Removes one or several objects from the scene. See also sim.removeModel.
Object destruction always tries to destroy attached scripts before destroying the object itself. If a script tries to destroy the object it is attached to, then the object will first be destroyed, and the script destruction will be delayed.
C/C++
synopsis
int simRemoveObjects(const int* objectHandles,int count)
C/C++
parameters
objectHandles: the handles of the objects to remove
count: the number of objects to remove
C/C++
return value
-1 if operation was not successful
Lua
synopsis
sim.removeObjects(int[] objectHandles)
Lua
parameters
Similar to the C-function counterpart
Lua
return values
Python
synopsis
sim.removeObjects(int[] objectHandles)