ptr_remove(void* object);
A7.07 Removes an engine object.
Parameters:
object - pointer of the object to be
removed; an ENTITY*, STRING*, BMAP*, VIEW*, PANEL*, TEXT*, FONT*, SOUND*, or MATERIAL* pointer.
Speed:
Medium
Remarks:
- This function is the opposite of the .._create functions. It can remove dynamically created as well as statically defined objects.
- The pointer
of a
removed object becomes invalid and must not be used anymore. Removing an already removed object will cause a crash.
Example:
ptr_remove(me); // Removes the me entity
See also:
ent_create,
ptr_for_handle, handle, ptr_first
► latest
version online