inq_called_segno(3G)

NAME

inq_called_segno − return the number of the segment referenced by the current element

SYNOPSIS

C Syntax:

void inq_called_segno(fildes, segno)
int fildes, *segno;

FORTRAN77 Syntax:

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

Pascal Syntax:

procedure inq_called_segno(fildes:integer; var segno:integer);

DESCRIPTION

Input Parameter

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

Output Parameter

segno Name of the called segment.

Discussion

Inq_called_segno returns the segment name referenced by the current element in the currently open segment of the specified graphics device. This element must be a call_segment, execute_segment, cond_call_segment or cond_execute_segment element.

EXAMPLE

If fd contains a gopen’ed file descriptor, and the current element of the current segment of fd’s display list is a call_segment element that calls segment 3, then the C call

inq_called_segno(fd, &segno);

will return in segno the name of the called segment, in this case, 3.

ERRORS

1 Graphics device not initialized for this operation.

24 Segment not open.

56 Current element is not a segment-referencing element.

Museum

Related Articles