Daylight v4.9
Release Date: 1 February 2008

Name

dt_mer_zapbelow - delete rows beyond a specified row in a hitlist

Generic Prototype

dt_mer_zapbelow(dt_Handle, dt_Integer) => dt_Integer

C Prototype

#include "dt_merlin.h"

dt_Integer dt_mer_zapbelow(dt_Handle hitlist, dt_Integer item)

FORTRAN Prototype

include 'dt_f_merlin.inc'

integer*4 dt_f_mer_zapbelow(hitlist, item)

integer*4 hitlist
integer*4 item

Description

Deletes all hits below, but not including, the specified hitlist item. If 'item' is greater than or equal to the number of hits in the hitlist, no hits are deleted. If 'item' is zero or less, all hits are deleted.

Return Value

Returns the length of the 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_native(3) dt_mer_reset(3) dt_mer_reverse(3) dt_mer_sethits(3) dt_mer_zapabove(3) dt_mer_zapna(3) dt_mer_zapnonunique(3)