4.106 SDDS_StartTable

• name:
  SDDS_StartTable
• description:
  Initializes a SDDS_TABLE structure in preparation for placing data into the table. Must be preceeded by a call to SDDS_InitializeOutput. May be called repeatedly to proceed to the next table in a data set, though the caller is expected to use SDDS_WriteTable to write each table to the disk
• synopsis: #include ”SDDS.h”
  int32_t SDDS_StartTable(SDDS_TABLE *SDDS_table, int32_t expected_n_rows);
• arguments:
  • SDDS_table: Address of the SDDS_TABLE structure for the data set.
  • expected_n_rows: The expected number of rows in the data table, used to preallocate memory for storing data values.
• return value:
  Returns 1 on success. On failure, returns 0 and records an error message.
• see also:
  • SDDS_InitializeOutput
  • SDDS_NumberOfErrors
  • SDDS_PrintErrors
  • SDDS_WriteTable