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 called by call_segment elements in the display list of the specified graphics device. If the specified segment does not exist, count is zero.

ERRORS

1 Graphics device is not initialized for this operation.

Museum

Related Articles