NAME

APPLICATION DATA − create a structure element containing application data

SYNOPSIS

C Syntax

void
pappl_data ( data )
Pdata∗data;application data

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

The APPLICATION DATA subroutine puts a structure element containing application data into the currently open structure. 

If the current edit mode is INSERT, the APPLICATION DATA element is inserted into the currently open structure after the element currently pointed to by the element pointer. If the edit mode is REPLACE, the APPLICATION DATA element replaces the element pointed to. In either case, the element pointer is updated to point to the new APPLICATION DATA element. 

C Input Parameter

data
A pointer to a Pdata structure containing the application data. Pdata is defined in phigs.h as follows:

typedef struct {
size_tsize; /∗ size of data ∗/
void∗data;/∗ pointer to data ∗/
} Pdata;

The size component specifies the number of bytes the data component is pointing to.

Execution

The APPLICATION DATA element is ignored during structure traversal. 

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

SEE ALSO

INQUIRE CURRENT ELEMENT TYPE AND SIZE (3P)
INQUIRE CURRENT ELEMENT CONTENT (3P)
INQUIRE ELEMENT TYPE AND SIZE (3P)
INQUIRE ELEMENT CONTENT (3P)

September 02, 1992