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

Name

mcf_st_cell_get_char — Copy the data of a sparse-table cell of type 'K' to a buffer

Synopsis

subroutine mcf_st_cell_get_char(dsid,row_index,column_index,data,status)


integer*4 dsid
integer*8 row_index
integer*8 column_index
character*(*) data
integer*4 status

Description

mcf_st_cell_get_char copies, for the sparse-table dataset identified by dsid, the data of the cell of type 'K' (character string), identified by the row index row_index and the column index column_index, to the buffer data. 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. The size of the data buffer must be at least the number of elements of the cell.

status (output)

Status code returned (output). If completed successfully, 0 is returned. Otherwise, a negative value indicating the MemCom error number is returned.

See Also

mcf_st_cell_get

mcf_st_cell_num_elements

mcf_st_cell_set

mcf_st_cell_set_char