Function
Body:destroy( )
When you don't have time to wait for garbage collection, this function may be used to free the object immediately, but note that an error will occur if you attempt to use the object after calling this function.

Also note that shapes and joints keep internal references to their relevant Bodies in order to prevent them from being deallocated while still in use. This means that the Body will only be destroyed immediately if all attatched shapes and joints have been destroyed. If you call Body:destroy before destroying the attatched shapes and joints, the Body will not really be destroyed until all relevant shapes and joints are destroyed too.
Synopsis
Body:destroy( )
Arguments
(None)
Returns
(Nothing)
Copyright © 2006-2008 LÖVE Development Team.