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.
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.