PA_GetTableName

version 2003

PA_GetTableName (tableNum; tableName)

Parameter	Type		Description
tableNum	short		Table number
tableName	char *		Name of the table

The routine PA_GetTableName returns in tableName the name of the table tableNumber.

Depending on previous calls to PA_UseVirtualStructure(), tableName will contains the real or the virtual name of the table. Remember that, when using virtual names, table numbers can also change.

Build an array of table names:

   void BuildTableNames (PA_Variable *aNames)
   {
      char      name[32]; // USING C STRINGS IN THIS EXAMPLE
      register long   i;
   // Do nothing if the array has a bad type
      if(theArray->fType != eVK_ArrayString)
         return;
   // Resize it
      PA_SetArrayNbElements(*aNames, PA_CountTables());
   // Fill it with table names
      for(i = 1; i <= PA_CountTables())
      {
         PA_GetTableName(i, name);
         PA_SetStringInArray(*aNames, i, name);
      }
   }

Table name.

Use PA_GetLastError to see if an error occurred.