NAME

COPY ALL ELEMENTS FROM STRUCTURE −  copy elements of specified structure into open structure

SYNOPSIS

C Syntax

void
pcopy_all_elems_struct ( struct_id )
Pintstruct_id;structure identifier

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

COPY ALL ELEMENTS FROM STRUCTURE copies the structure elements of the structure identifier into the currently open structure. The elements are copied into the open structure after the element pointed to by the element pointer. 

C Input Parameter

struct_id
Identifies the structure from which to copy the elements.

Execution

The COPY ALL ELEMENTS FROM STRUCTURE subroutine copies all the structure elements in the source structure identifier and inserts them into the currently open structure after the element pointed to by the element pointer. The element pointer is then updated to point to the last element inserted. The current edit mode has no effect on this subroutine.  If source structure identifier is the open structure, its contents are copied into itself after the element pointed to by the element pointer. If source structure identifier refers to an empty structure or to a structure that does not exist, the subroutine does not perform any action and does not generate an error.

ERRORS

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

SEE ALSO

CHANGE STRUCTURE IDENTIFIER (3P)
EXECUTE STRUCTURE (3P)

September 02, 1992