NAME

COPY ELEMENTS BETWEEN LABELS - copy all elements in the source structure between specified labels to the open structure

SYNOPSIS

C Syntax

void pcopy_elems_labels ( struct_id, label1_id, label2_id )

Pint   struct_id;   source structure identifier
Pint   label1_id;   label 1 identifier
Pint   label2_id;   label 2 identifier

FORTRAN Syntax

SUBROUTINE pcellb ( STRID, LABEL1, LABEL2 )

INTEGER      STRID                source structure identifier
INTEGER      LABEL1, LABEL2       label range

Required PHIGS Operating States

(PHOP, * ,STOP, * )

DESCRIPTION

Purpose

COPY ELEMENTS BETWEEN LABELS copies structure elements in the source structure between two specified labels to the open structure. The elements containing the labels are not copied.

C Input Parameters

struct_id

The subroutine copies elements from this structure.

label1_id

The subroutine begins copying elements with the structure element immediately following this label.

label2_id

The subroutine ends copying elements with the structure element immediately preceding this label.

FORTRAN Input Parameters

STRID

The subroutine copies elements from this structure.

LABEL1

The subroutine begins copying elements with the structure element immediately following this label.

LABEL2

The subroutine ends copying elements with the structure element immediately preceding this label.

Execution

The COPY ELEMENTS BETWEEN LABELS subroutine copies all the elements in the source structure between the two specified labels 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.

If the source structure identifier is the open structure, the subroutine searches for the specified labels from the current position of the element pointer in the structure to the end of the structure. The next occurrence of an element containing label 1 identifier is first found; then, starting from the element containing label 1 identifier, the next occurrence of an element containing label 2 identifier is found.

If the source structure identifier is not the open structure, the subroutine searches for the specified labels from the first element in the structure to end of the structure. The first occurrence of an element containing label 1 identifier is first found; then, starting from the element containing label 1 identifier, the next occurrence of an element containing label 2 identifier is found.

If either of the label identifiers cannot be found, no elements are copied and an error is generated.

ERRORS

005

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

206

Ignoring function, one or both of the labels does not exist in the open structure between the element pointer and the end of the structure

-176

Ignoring function, the starting label does not exist in the structure

-177

Ignoring function, the label does not exist in the structure between the starting label and the end of the structure

SEE ALSO

COPY ALL ELEMENTS FROM STRUCTURE (3P)

COPY ELEMENT RANGE (3PP)