2.3 Output Routines

2.3.1 Setup

• SDDS_InitializeCopy — Initializes a SDDS_TABLE structure in preparation for internally copying the current data table of another data set.
• SDDS_InitializeOutput — Initializes a SDDS_TABLE structure in preparation for output of data to a data set. This includes opening the file but not writing the SDDS header, which is yet to be defined.
• SDDS_StartTable — Signals the beginning of a new data table of a data set that is being created in a program. Usually calls to this routine are interleaved with calls to SDDS_WriteTable.
• SDDS_CopyTable — Copies the current data table from one data set structure to another. The target data set is usually set up using SDDS_InitializeCopy.

2.3.2 Defining Data Set Elements

• SDDS_DefineArray — Defines a new array for a data set.
• SDDS_DefineColumn — Defines a new tabular-data column for a data set.
• SDDS_DefineParameter — Defines a new data table parameter for a data set.

2.3.3 Defining Data Table Elements

• SDDS_SetArray — Sets the values in an array for the current table of a data set.
• SDDS_SetParameters — Sets the values of parameters for the current table of a data set.
• SDDS_SetRowValues — Sets the values of tabular data for the current table of a data set.

2.3.4 Output

• SDDS_WriteLayout — Writes the SDDS header to the file defined by a previous call to SDDS_InitializeOutput or SDDS_InitializeCopy. The contents of the header must have been previously defined by calls to the SDDS_Define X routines.
• SDDS_WriteTable — Writes the current data table to the data set file. The contents of the table must have been previously defined by calls to SDDS_SetArray, SDDS_SetParameters, and SDDS_SetRowValues.