PA_CreateEmptySet

version 2003

PA_CreateEmptySet (tableNum; setName)

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

Description

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


   
    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 .

Error Handling


 
  
   PA_GetLastError

can be called to see if an error occurred