Daylight v4.9
Release Date: 1 February 2008

Name

dt_mer_cellvalue - retrieve the value of a cell in a hitlist row and column

Generic Prototype

dt_mer_cellvalue(dt_Handle, dt_Handle, dt_Integer) => dt_String

C Prototype

#include "dt_merlin.h"

dt_String dt_mer_cellvalue(dt_Integer *len, dt_Handle column, dt_Handle hitlist, dt_Integer item)

FORTRAN Prototype

include 'dt_f_merlin.inc'

integer*4 dt_f_mer_cellvalue(column, hitlist, item, string)

integer*4 column
integer*4 hitlist
integer*4 item
character*() string

Description

Gets the value of the "cell" - the value from the 'item' position of the hitlist in the specified column. The string returned 'belongs' to the toolkit and should be used or copied immediately. The next toolkit call may reuse the string buffer.

Return Value

Returns the string value of the cell. The string value for all combinations of objects other than columns and hitlists is defined as the 'invalid string'.

Related Topics

dt_mer_alloc_hitlist(3) dt_mer_clear(3) dt_mer_combinehitlists(3) dt_mer_hit2id(3) dt_mer_id2hit(3) dt_mer_invert(3) dt_mer_length(3) dt_mer_mvbottom(3) dt_mer_mvtop(3) dt_mer_native(3) dt_mer_reset(3) dt_mer_reverse(3) dt_mer_sethits(3) dt_mer_zapabove(3) dt_mer_zapbelow(3) dt_mer_zapna(3) dt_mer_zapnonunique(3)