 | |  |  |  |  |
| | | | | |
mcf_st_cell_set — Set the cell data
subroutine mcf_st_cell_set(dsid,row_index,column_index,num_elements,data,status) integer*4 dsid integer*8 row_index integer*8 column_index integer*8 num_elements integer|real data(*) integer*4 status
mcf_st_cell_set copies, for the
sparse-table dataset identified by dsid, and for
the cell identified by the row index row_index
and the column index column_index, the data from
the buffer data to the cell's internal in-memory
buffer.
mcf_st_cell_set can be used for all
column data types except 'K' (character strings). For the latter,
use mcf_st_cell_set_char
instead.
mcf_st_cell_set renders previously empty
cells non-empty. In this case, the row's sorting order will not be
maintained for reasons of computational efficiency. To sort the
non-empty cells inside a row, use mcf_st_row_sort. To empty a
cell, use mcf_st_cell_clear.
dsid (input)Dataset identifier.
row_index (input)Row index, starting at 1.
column_index (input)Index of the column whose data is requested. Column indices start at 1.
num_elements (input)The number of elements of the cell. For fixed-sized columns, this parameter must match the column's num_elements attribute.
data (input)Buffer containing the new cell data. The element data
type must match the column's data type. The number of
elements of the buffer must be
num_elements.
status (output)If no error occurred, 0 is returned. Otherwise, a negative value indicating the MemCom error number is returned.