SdsFreeIdCheck - Free an identifier so that its associated memory may be reused. Check id.

Function

Free an identifier so that its associated memory may be reused. Check id.

Description

Each identifier allocated by SDS uses memory. To avoid excessive allocation of memory the SdsFreeId function can be used to free memory associated with an identifier that is no longer needed. When this is done the memory will be reused by SDS for a subsequent identifier when needed.

This version will check that SdsDelete()/SdsFreeId() have been run, if required.

Call

SdsFreeIdCheck id

Parameters

idintThe SDS identifier to be freed.

Language

Tcl

See Also

DTCL manual, Sds manual, ArgDelete(3), SdsFreeId(n), SdsFreeIdAndCheck(3), SdsDelete(n), ArgDelete(n)

Support

Tony Farrell, AAO

Click here for the DRAMA home page and here for the AAO home page.

 For more information, contact tony.farrell@mq.edu.au