PA_ClearNamedSelection


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