Daylight v4.9
Release Date: 1 February 2008

Name

dt_mer_native - reset the row order of a hitlist to native order

Generic Prototype

dt_mer_native(dt_Handle) => dt_Integer

C Prototype

#include "dt_merlin.h"

dt_Integer dt_mer_native(dt_Handle hitlist)

FORTRAN Prototype

include 'dt_f_merlin.inc'

integer*4 dt_f_mer_native(hitlist)

integer*4 hitlist

Description

Reorders the hitlist to "native" order without changing its contents. Native order is essentially arbitrary. It may correspond to the order in which the database was loaded, but should not be assumed to be so. The only guarantee is that "native" order will not change over the life of the database object.

Return Value

Returns the number of hits in the resulting hitlist. 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_hit2id(3) dt_mer_id2hit(3) dt_mer_invert(3) dt_mer_length(3) dt_mer_mvbottom(3) dt_mer_mvtop(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)