[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

EXECUTE STRUCTURE (PHOP,*,STOP,*)

Purpose

Use Execute Structure to insert an Execute Structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with an Execute Structure element, depending on the current edit mode. If the specified structure does not exist, Execute Structure creates a new empty structure.

Traversal of the structure in which the Execute Structure element exists causes invocation of the target structure as soon as the Execute Structure element is encountered. Although the graPHIGS API does not allow recursive structure networks, no error is generated by the creation of such a network. When the application attempts to execute the open structure, the graPHIGS API generates an implementation error (-125). This is a graPHIGS API restriction. The behavior of the graPHIGS API when traversing a recursive structure network is undefined.

Language Bindings

C

pexec_struct (struct_id)

Input Parameters

Pint struct_id
Structure identifier.

FORTRAN

PEXST (strid)

Input Parameters

integer strid
Structure identifier.

Errors

5
Function Requires State (PHOP,*,STOP,*)

Related Subroutines

  • None


  • [ Previous | Next | Contents | Glossary | Home | Search ]