DELETE_SEGMENT(3G)

NAME

delete_segment, delete_segment_and_references − delete a segment or delete a segment and all references to it

SYNOPSIS

C Syntax:

void delete_segment(fildes,segno)
int fildes,segno;

void delete_segment_and_references(fildes,segno)
int fildes,segno;

FORTRAN77 Syntax:

subroutine delete_segment(fildes,segno)
integer*4 fildes,segno

subroutine delete_segment_and_references(fildes,segno)
integer*4 fildes,segno

Pascal Syntax:

procedure delete_segment(fildes,segno:integer);
procedure delete_segment_and_references(fildes,segno:integer);

DESCRIPTION

Input Parameters

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

segno Name of the segment to delete.

Discussion

Delete_segment removes the specified segment from the display list of the specified graphics device if the specified segment is not referenced by another segment. Otherwise, the specified segment is replaced by an empty segment to satisfy the reference.

Delete_segment_and_references removes the specified segment from the display list of the specified graphics device as well as all references to the specified segment from other segments of the specified graphics device’s display list. When this call deletes elements from a segment, the element pointer in the affected segment is changed accordingly.

If the specified segment does not exist, no error is generated.

ERRORS

1 Graphics device is not initialized for this operation.

Museum

Related Articles