{{oldin|[[0.8.0]]|080|type=function}}
Explicitly destroys the Shape.
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.

Note that Box2D doesn't allow destroying or creating shapes during collision callbacks.


== Function ==
=== Synopsis ===
<source lang="lua">
Shape:destroy( )
</source>
=== Arguments ===
None.
=== Returns ===
Nothing.
== See Also ==
* [[parent::Shape]]
[[Category:Functions]]
{{#set:Description=Explicitly destroys the Shape.}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|Shape:destroy}}