Daylight v4.9
Release Date: 1 February 2008

Name

dt_mer_getdata - retrieve a field item from a row of a hitlist

Generic Prototype

dt_mer_getdata(dt_Handle, dt_Integer, dt_Handle, dt_Integer) => dt_String

C Prototype

#include "dt_merlin.h"

dt_String dt_mer_getdata(dt_Integer *len, dt_Handle hitlist, dt_Integer item, dt_Handle fieldtype, dt_Integer count)

FORTRAN Prototype

include 'dt_f_merlin.inc'

integer*4 dt_f_mer_getdata(hitlist, item, fieldtype, count, string)

integer*4 hitlist
integer*4 item
integer*4 fieldtype
integer*4 count
character*() string

Description

Gets the 'count' occurrence of a specific fieldtype 'fieldtype' in row 'item' of the hitlist. 'fieldtype' is a fieldtype indicating which type of data is desired. It allows the retrieval of data even if a column of the specified type does not exist. 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 field item or 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)