PA_CreateEmptySet

version 2003

PA_CreateEmptySet (tableNum; setName)

Parameter	Type		Description
tableNum	short		Table number
setName	char *		Name of the set

The command PA_CreateEmptySet creates a new empty set (of name setName) for the table number tableNum. You can add records to this set with the PA_AddToSet. If a set with the same name already exists, the existing set is cleared by the new set.

setName can be a standard C string null terminated or a Pascal string, depending on previous calls to PA_USePStrings or PA_UseCStrings.

Note: You do not need to use PA_CreateEmptySet before using PA_CreateSet.

This is the same as the CREATE EMPTY SET command, except for the table number, which is not required by the 4D command. 4th Dimension expects the table number of the table passed to tableNum to be the table number that owns the set.

Once a set has been created using PA_CreateEmptySet, the 4D plug-in can:

• Reuse the set to create a selection for the Table using PA_UseSet.

• Add records to the set using the entry point PA_AddToSet.

• Delete the set when it is no longer needed using PA_DeleteSet.

CREATE EMPTY SET, PA_AddToSet, PA_CreateSet, PA_UseSet.

PA_GetLastError can be called to see if an error occurred