delete_eles(3G)

NAME

delete_eles − delete elements from the currently open segment

SYNOPSIS

C Syntax:

void delete_eles(fildes, count)
int fildes, count;

FORTRAN77 Syntax:

subroutine delete_eles(fildes, count)
integer*4 fildes, count

Pascal Syntax:

procedure delete_eles(fildes, count:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

count Specifies how many elements to delete. Must be a non-negative value.

Discussion

Delete_eles deletes elements from the currently open segment of the specified graphics device. Count elements are deleted starting with the current element.

If count is greater than the number of elements from the current element to the end of the segment, only those elements from the current element to the end of the segment are deleted.

After deletion, the element pointer is set to point to the element following the deleted elements. If the last element of the segment was deleted, the element pointer is set to point to the new last element of the segment.

Element 0 cannot be deleted. If delete_eles is called while the current element is element 0, an error is generated.

If count is zero, no elements are deleted and no error is generated.

ERRORS

1 Graphics device is not initialized for this operation.

6 Improper parameter value - count is negative.

24 No open segment.

36 Current element is element 0 - cannot delete element 0.

Museum

Related Articles