inq_num_refs(3G)

NAME

inq_num_refs − return number of references to specified segment

SYNOPSIS

C Syntax:

void inq_num_refs(fildes, segno, count)
int fildes, segno, *count;

FORTRAN77 Syntax:

subroutine inq_num_refs(fildes, segno, count)
integer*4 fildes, segno, count

Pascal Syntax:

procedure inq_num_refs(fildes, segno:integer;
var count: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

count Number of references to the specified segment.

Discussion

Inq_num_refs returns the number of times the specified segment is referenced by call_segment, execute_segment, cond_call_segment or cond_execute_segment elements in the display list of the specified graphics device. If the specified segment does not exist, count is zero.

Inq_num_refs differs from inq_calling_segment_count in that inq_num_refs counts one reference for every segment-referencing element while inq_calling_segment_count counts one segment for every segment that contains 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