STAB_Destroy

The STAB_Destroy function releases memory used by a STAB (string table) object. After the object is deleted, the specified handle is no longer valid.

extern STAB_Destroy
  float handle   // handle to STAB object

Parameters

handle

[in] Handle to a STAB object previously returned from STAB_Create.

Remarks

You need to call STAB_Destroy to release memory resources used by the STAB object only if you no longer need the object before the level exits. All STAB objects are automatically destroyed upon level exit.

If handle is not a valid STAB handle, an error message will be printed to the console.

Example

extern STAB_Create handle
.
// Do some stuff with the STAB object,
// and then, when you are done...
.
extern STAB_Destroy handle