NAME

SET ELEMENT POINTER − set element pointer to specified pointer value

SYNOPSIS

C Syntax

void
psetelemptr ( ep_value )
Pintep_value;element pointer value

FORTRAN Syntax

SUBROUTINE psep ( EP )
INTEGEREPelement pointer value

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

Use SET ELEMENT POINTER to set the element pointer in the currently open structure to point to the element numbered element pointer value. Editing of the structure contents, such as adding or deleting elements, is done in relation to the current element pointer position. 

C Input Parameter

ep_value
Specifies the number of the structure element in the currently open structure to which the element pointer should be set.

FORTRAN Input Parameter

EP
Specifies the number of the structure element in the currently open structure to which the element pointer should be set.

Execution

The SET ELEMENT POINTER subroutine sets the current element pointer to element pointer value. The element pointer value is the number of the element in the currently open structure at which operations on the structure contents begin. For example, subroutines which add new structure elements put the new element into the currently open structure in relation to the element pointer; the new element is inserted into the structure after the element pointed to by the element pointer or replaces the element pointed to by the element pointer.  If the pointer value is specified as less than 0, the element pointer is set to 0. If element pointer value is greater than the number of elements in the open structure, the element pointer will be set to the last element in the structure. 

ERRORS

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

SEE ALSO

OFFSET ELEMENT POINTER (3P)
INQUIRE ELEMENT POINTER (3P)
INQUIRE CURRENT ELEMENT TYPE AND SIZE (3P)
SET ELEMENT POINTER AT LABEL (3P)
SET ELEMENT POINTER AT PICK IDENTIFIER (3P+)
ELEMENT SEARCH (3P)

Sun Release 4.0  —  Last change: 13 July 1989