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

GPCPST - Copy Structure

GPCPST (strid)

Purpose

Use GPCPST to copy the elements from the specified structure and to insert the elements into the open structure following the current element pointer. The element pointer moves to the last element copied into the open structure.

The value of the edit mode set by GPEDMO does not affect the functionality of this subroutine.

If the structure you copy references the open structure (by the use of an execute structure-type element), then the graPHIGS API issues an error message and does not perform the copy.

Parameters

strid -- specified by user, fullword integer

Identifier of the structure whose contents are copied.

Error Codes

4
FUNCTION REQUIRES STATE STOP
125
ATTEMPTING TO EXECUTE THE OPEN STRUCTURE

Related Subroutines

GPCEXS
Conditional Execute Structure
GPEXST
Execute Structure

RCP code

201338625 (X'0C002F01')


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