 | |  |  |  |  |
| | | | | |
mcf_st_col_append — Append a new column to a sparse-table dataset
subroutine mcf_st_col_append(dsid,name,type,num_elements,column_index) integer*4 dsid character*(*) name character*(*) type integer*8 num_elements integer*8 column_index
mcf_st_col_append appends, for the
sparse-table dataset identified by dsid, a new
column whose name is defined by name, whose data
type is defined by type, and whose number of data
elements is defined by num_elements. If a column
with the same name is already defined, its attributes are
cross-checked againts type and
num_elements, and column index
will contain the index of that column.
dsid (input)Dataset identifier.
name (input)The name of the column. Column names are unique per dataset.
type (input)The data element type for the column. Valid choices are 'I', 'J', 'E', 'F', 'C', 'Z', and 'K'.
num_elements (input)Defines the number of data elements for the column. If
positive, indicates a fixed-sized column. In this case, all
cells of this column are arrays of
num_elements elements. If 0, indicates a
variable-sized column. where each cell belonging to this
column may have a different number of data elements.
column_index (output)If the column could be added successfully or if the column already exists and its attributes match, the column index (starting from 1) is returned. If the column is new, the returned column index is is equal to the current number of columns, as obtained by calling mcf_st_col_num.
In case of error, a negative value indicating the MemCom error number is returned.