PA_GetTableName


version 2003


PA_GetTableName (tableNum; tableName)

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

Description

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.

Example

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);
      }
   }

See Also

Table name .

Error Handling

Use PA_GetLastError to see if an error occurred.