COPY ALL ELEMENTS FROM STRUCTURE(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
pcopyallelemsstruct ( struct_id )
Pintstruct_id;structure identifier

FORTRAN Syntax

SUBROUTINE pcelst ( STRID )
INTEGERSTRIDstructure 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.

FORTRAN Input Parameter

STRID
Identifies the structure from which to copy the elements.

Execution

The COPY ALL ELEMENTS FROM STRUCTURE subroutine copies all the structure elements in the structure 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 structure identifier is the open structure, its contents are copied into itself after the element pointed to by the element pointer. If 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, ∗)

Museum