 | |  |  |  |  |
| | | | | |
mcf_st_cell_set_char — Set data for a character-string cell.
subroutine mcf_st_cell_set_char(dsid,row_index,column_index,data,status) integer*4 dsid integer*8 row_index integer*8 column_index character*(*) data integer*4 status
mcf_st_cell_set_char copies, for the
sparse-table dataset identified by dsid, and for
the cell (whose column is of type 'K'), identified by the row index
row_index and the column index
column_index, the data from the character string
data to the cell's internal in-memory
buffer.
mcf_st_cell_set_char 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.
data (input)Contains the new cell data. For fixed-size columns,
the string length plus one must be smaller or equal to the
column's num_elements attribute. For
variable-size columns, the cell's new number of elements
will be the string length plus one.
status (output)If no error occurred, 0 is returned. Otherwise, a negative value indicating the MemCom error number is returned.