MemCom Reference Manual > MemCom ftn Fortran API > Sparse Table Functions > mcf_st_cell_get

Name

mcf_st_cell_get — Copy the data of a sparse-table cell to a buffer

Synopsis

subroutine mcf_st_cell_get(dsid,row_index,column_index,data,status)
integer*4 dsid
integer*8 row_index
integer*8 column_index
integer|real data(*)
integer*4 status

Description

mcf_st_cell_get copies, for the sparse-table dataset identified by dsid, the data of the cell identified by the row index row_index and the column index column_index to the bufferdata. If the cell is empty, no data is transferred.

Parameters

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 (output)

Data buffer to which data are transferred (input). The data type of the data buffer must correspond to the expected data type. The size of the data buffer must be at least the number of elements of the cell.

status (output)

If no error occurred and the cell is not empty, a pointer to the buffer containing the cell data is returned. In case of errors the MemCom error is returned.

See Also

mcf_st_cell_get_char

mcf_st_cell_num_elements

mcf_st_cell_set

mcf_st_cell_set_char