NAME

DgDelEleBetweenLabels − Remove all elements between labels from the currently open group

SYNOPSIS

C:

DtFlag DgDelEleBetweenLabels(label1, label2)
DtInt label1;
DtInt label2;

FORTRAN:

INTEGER∗4 DGDEL(LABEL1, LABEL2)
INTEGER∗4 LABEL1
INTEGER∗4 LABEL2

DESCRIPTION

DgDelEleBetweenLabels deletes all of the elements between two labels, label1 and label2, from the currently open group.  Labels are elements that can be placed anywhere within a group to mark a special location.  There may be more than one label with the same value. 

DgDelEleBetweenLabels searches forward from the current position for the first occurrence of label1. If found, a search is then made from that point for the first occurrence of label2.  If both labels are found, then DgDelEleBetweenLabels deletes all the elements between the labels but not the labels themselves.  After the deletion, the element pointer will end up pointing to the second label and DcTrue <DCTRUE> will be returned.  If only one or none of the labels is found, DcFalse <DCFALS> will be returned, and the element pointer is not moved. 

ERRORS

DgDelEleBetweenLabels will fail if no group is currently open.  DcFalse <DCFALS> will be returned. 

[WARNING - a group is not currently open]

DgDelEleBetweenLabels will fail if passed an invalid label. 

[WARNING - can’t find first label]

[WARNING - can’t find second label]

SEE ALSO

DgDelEle(3D), DgDelEleRange(3D), DgEmpty(3D), DoLabel(3D)

September 02, 1992