inq_calling_segment(3G)

NAME

inq_calling_segment_list, inq_calling_segment_count − return information about segments that call a given segment

SYNOPSIS

C Syntax:

void inq_calling_segment_count ( fildes, segno, seg_count )
int fildes, segno, *seg_count;

void inq_calling_segment_list ( fildes, segno, seg_list )
int fildes, segno, seg_list[];

FORTRAN77 Syntax:

subroutine inq_calling_segment_count ( fildes, segno, seg_count )
integer*4 fildes, segno, seg_count

subroutine inq_calling_segment_list ( fildes, segno, seg_list )
integer*4 fildes, segno, seg_list (*)

Pascal Syntax:

procedure inq_calling_segment_count ( fildes, segno:integer;
var seg_count:integer );

procedure inq_calling_segment_list ( fildes, segno:integer;
var seg_list: array[lo..hi: integer] of integer );

DESCRIPTION

Input Parameters

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

segno Segment name.

Output Parameters

seg_count Number of segments calling the specified segment.

seg_list Buffer in which the list of segments calling the specified segment is returned.

Discussion

Inq_calling_segment_list and inq_calling_segment_count return information about the segments that call the specified segment. These calls can be made by any of the elements call_segment, execute_segment, cond_call_segment or cond_execute_segment.

Inq_calling_segment_count returns the number of segments calling the specified segment. The seg_list parameter passed to inq_calling_segment_list must be at least this size.

Inq_calling_segment_list returns, in the specified buffer seg_list, the list of segment names of those segments that call the specified segment.

Inq_calling_segment_count differs from inq_num_refs in that inq_num_refs counts one reference for every segment-referencing element, while inq_calling_segment_count counts one segment for every segment containing one or more segment-referencing elements. The difference is only apparent if a single segment is referenced multiple times by the same segment.

ERRORS

1 Graphics device is not initialized for this operation.

Museum

Related Articles