inq_application_data(3G)

NAME

inq_application_data, inq_application_data_size − return information about application data in the current element of the currently open segment

SYNOPSIS

C Syntax:

void inq_application_data_size(fildes, size)
int fildes, *size;

void inq_application_data(fildes, data)
int fildes;
char *data;

FORTRAN77 Syntax:

subroutine inq_application_data_size(fildes, size)
integer*4 fildes, size

subroutine inq_application_data(fildes, data)
integer*4 fildes
character*(*) data

Pascal Syntax:

procedure inq_application_data_size(fildes:integer;
var size:integer);

procedure inq_application_data(fildes:integer;
var packed array[lo..hi] of char);

DESCRIPTION

Input Parameters

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

Output Parameters

size Size, in bytes, of the application data in the current element.

data Buffer within which application data in the current element is returned.

Discussion

Inq_application_data_size and inq_application_data return information about the application data in the current element of the currently open segment of the specified graphics device. Use application_data(3G) to place application data into a segment.

Inq_application_data_size returns the size (in bytes) of the application data. The data parameter passed to inq_application_data must be at least this size.

Inq_application_data returns the application data in the specified buffer data.

If no segment is open, an error is generated and the return data is left unchanged.

The contents of element 0 cannot be inquired. If the current element is element 0, an error is generated and the return data is left unchanged.

The current element must be an application_data element. If it is not, an error is generated and the return data remains unchanged.

ERRORS

1 Graphics device is not initialized for this operation.

24 Segment not open.

36 Element pointer at element 0.

37 Current element is not an application data element.

Museum

Related Articles