NAME

SET ELEMENT POINTER − set element pointer to specified pointer value

SYNOPSIS

C Syntax

void
pset_elem_ptr ( ep_value )
Pintep_value;element 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 ep_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.

Execution

The SET ELEMENT POINTER subroutine sets the current element pointer to ep_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 that 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 the 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)

September 02, 1992