Previous Next Up Title Contents Index Functions Index Top Library

CHANGE STRUCTURE REFERENCES

PCHANGE_STRUCT_REFS


CALL SEQUENCE

void pchange_struct_refs(
)

PHIGS STATE

(PHOP, *, *, *).

EFFECT

This function changes all the references made to the orig_struct_id structure. The references are both modified in the execute structure orig_struct_id and in the posted structures.

execute structure orig_struct_id

All the EXECUTE STRUCTURE elements in the CSS referring to orig_struct_id are replaced by result_struct_id.

If result_struct_id does not exist, result_struct_id is created as an empty structure.

posted structure

If orig_struct_id is posted on a workstation, it is unposted, and result_struct_id is posted in its place with the same priority.

If the two structures orig_struct_id and result_struct_id are posted, then orig_struct_id is unposted.

These modifications are immediately taken into account. The visual effect of this function depends on the current state of the workstation update.

ERRORS

2
Ignoring function, function requires state (PHOP, *,*,*)

SEE ALSO

open structure, copy all elements from structure, change structure identifier, change structure identifier and references, inquire structure identifiers, inquire structure status


Previous Next Up Title Contents Index Functions Index Top Library