Previous: SDDS_PrintTypedValue
Up: Manual Pages
Next: SDDS_SetArray
Previous Page: SDDS_PrintTypedValue
Next Page: SDDS_SetArray

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"
  long 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