version 2003
PA_ClearNamedSelection (selName)
Parameter | Type | Description | |
selName | char * | Name of the named selection to be cleared |
Description
The routine PA_ClearNamedSelection clears selName from memory and frees the memory used by it. It does not affect tables, selections, or records. Since named selections use memory, it is good idea to clear named selections when they are no longer needed.
If the name was created using the PA_CutNamedSelection command and then manipulated using the PA_UseNamedSelection command, selName no longer exists in memory. In this case, PA_ClearNamedSelection does not need to be used.
Example
See PA_CutNamedSelection for an example of use.
See Also
CLEAR NAMED SELECTION, Named selections and 4DPluginAPI, PA_CopyNamedSelection.
Error Handling
Use PA_GetLastError to see if an error occurred