NAME

COPY ELEMENT RANGE - copy a block of elements from the source structure to the open structure

SYNOPSIS

C Syntax

void

pcopy_elem_range ( struct_id, ep1_value, ep2_value )

Pint   struct_id;    source structure identifier
Pint   ep1_value;    element pointer 1 value
Pint   ep2_value;    element pointer 2 value

FORTRAN Syntax

SUBROUTINE pcelra ( STRID, EP1, EP2 )

INTEGER      STRID       source structure identifier
INTEGER      EP1, EP2    element pointer range

Required PHIGS Operating States

(PHOP, * ,STOP, * )

DESCRIPTION

Purpose

COPY ELEMENT RANGE copies all structure elements in the source structure between two specified element numbers, inclusive, to the open structure.

C Input Parameters

struct_id

Specifies the structure from which elements will be copied.

ep1_value

Specifies the beginning of the element range to be copied.

ep2_value

Specifies the end of the element range to be copied.

FORTRAN Input Parameters

STRID

Specifies the structure from which elements will be copied.

EP1

Specifies the beginning of the element range to be copied.

EP2

Specifies the end of the element range to be copied.

Execution

The COPY ELEMENT RANGE subroutine copies structure elements from the source structure between and including the lower and the higher of the element positions specified by the element pointer 1 value and element pointer 2 value into the open structure. The elements are copied into the open structure following the element pointed to by the element pointer. The element pointer is updated to point to the element last inserted. The current edit mode has no effect on this function.

When an element position is less than 1, the range of elements copied starts from element position 0. When an element position is greater than the number of elements in the open structure, the range of elements copied ends at the last element of the source structure.

ERRORS

005

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

SEE ALSO

COPY ALL ELEMENTS FROM STRUCTURE (3P)

COPY ELEMENTS BETWEEN LABELS (3PP)