4.86 SDDS_ReadTable

• name:
  SDDS_ReadTable
• description:
  Reads a new data table from a data set. The data set must have previously been initialized using SDDS_InitializeInput.
• synopsis: #include ”SDDS.h”
  int32_t SDDS_ReadTable(SDDS_TABLE *SDDS_table);
• arguments:
  • SDDS_table: Address of the SDDS_TABLE structure for the data set.
• return value:
  On success, returns a positive integer giving the “table number” being returned. This is a value that is 1 for the first table and increments by 1 for each subsequent table. -1 is returned if there are no tables remaining in the data set.
  
  On failure, returns 0 and records an error message.
• see also:
  • SDDS_InitializeInput
  • SDDS_NumberOfErrors
  • SDDS_PrintErrors