Daylight v4.9
Release Date: 1 February 2008


dt_mer_hit2id - convert a hitlist index to a row identifier

Generic Prototype

dt_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 Prototype

include ''

integer*4 dt_f_mer_hit2id(hitlist, item)

integer*4 hitlist
integer*4 item


Converts 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 Value

Returns the id of the hitlist item. For all other objects, this property is defined as -2.

Related Topics

dt_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)