SDDS_InitializeOutput

• name:
  SDDS_InitializeOutput
• description:
  Initializes a SDDS_TABLE structure for use writing data to a SDDS file. This involves opening zeroing all elements of the structure and opening the file.
• synopsis: #include "SDDS.h"
  long SDDS_InitializeOutput(SDDS_TABLE *SDDS_table, long data_mode, long lines_per_row, char *description, char *contents, char *filename)
• arguments:
  • SDDS_table: Address of the SDDS_TABLE structure for the data set.
  • data_mode: On of the constants SDDS_ASCII or SDDS_BINARY, defined in SDDS.h.
  • lines_per_row: A positive integer giving the number of lines to use for each row of data in ASCII output mode.
  • description: A NULL-terminated character string informally describing the data set.
  • contents: A NULL-terminated character string formally specifying the data set. Users are advised to set and/or examine this value in order to uniquely identify different types of data sets, using a set of description keywords chosen by the applications programmer.
  • filename: A NULL-terminated character string giving the name of the file to set up for output.
• return value:
  Returns 1 on success. On failure, returns 0 and records an error message.
• see also:
  • SDDS_DefineParameter
  • SDDS_DefineColumn
  • SDDS_WriteLayout
  • SDDS_WriteTable
  • SDDS_NumberOfErrors
  • SDDS_PrintErrors