Release Date: 1 February 2008
Namedt_mer_hit2id - convert a hitlist index to a row identifier
Generic Prototypedt_mer_hit2id(dt_Handle, dt_Integer) => dt_Integer
C Prototype#include "dt_merlin.h"
dt_Integer dt_mer_hit2id(dt_Handle hitlist, dt_Integer item)
FORTRAN Prototypeinclude 'dt_f_merlin.inc'
integer*4 dt_f_mer_hit2id(hitlist, item)
DescriptionConverts a row's hitlist index 'item' to its id. An id is an arbitrary but unique integer that identifies a particular row in a hitlist. You can ask for the id of a row in one hitlist, then use its id to find the row's position (hitlist index) in another hitlist or in a modified version of the original hitlist. An id has no other use.
An id is guaranteed to be unique and invariant over the life of a pool. No other assumptions should be made about the properties of an id.
Return ValueReturns the id of the hitlist item. For all other objects, this property is defined as -2.
Related Topicsdt_mer_alloc_hitlist(3) dt_mer_clear(3) dt_mer_combinehitlists(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)