Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Object.DestroyImmediate

static function DestroyImmediate(obj: Object, allowDestroyingAssets: bool = false): void;
static void DestroyImmediate(Object obj, bool allowDestroyingAssets = false);
static def DestroyImmediate(obj as Object, allowDestroyingAssets as bool = false) as void

Parameters

objObject to be destroyed.
allowDestroyingAssetsSet to true to allow assets to be destoyed.

Description

Destroys the object obj immediately. You are strongly recommended to use Destroy instead.

This function should only be used when writing editor code since the delayed destruction will never be invoked in edit mode. In game code you should use Object.Destroy instead. Destroy is always delayed (but executed within the same frame). Use this function with care since it can destroy assets permanently! Also note that you should never iterate through arrays and destroy the elements you are iterating over. This will cause serious problems (as a general programming practice, not just in Unity).