.\"##
.\" $XConsortium: p315,v 5.2 94/04/17 20:58:05 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "SET ELEMENT POINTER" 3P "29 February 1991"
.SH NAME
SET ELEMENT POINTER \- set element pointer to specified pointer value
.IX "Editing" "SET ELEMENT POINTER"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pset_elem_ptr ( ep_value )
Pint	ep_value;	\fIelement pointer value\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
.IX "Element Pointer" "SET ELEMENT POINTER"
.IX "Current Element Pointer" "SET ELEMENT POINTER"
Use \s-2SET ELEMENT POINTER\s+2 to set the element pointer in the currently open structure to point to the element numbered \fIep_value\fP. Editing of the structure contents, such as adding or deleting elements, is done in relation to the current element pointer position.
.SS C Input Parameter
.IP \fIep_value \fP
Specifies the number of the structure element in the currently open structure 
to which the element pointer should be set.
.SS Execution
The \s-2SET ELEMENT POINTER\s+2 subroutine sets the current element
pointer to \fIep_value\fP. 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.
.LP
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.
.SH ERRORS
.IP 005
Ignoring function, function requires state 
(\s-2PHOP\s+2, \s-2*\s+2, \s-2STOP\s+2, \s-2*\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "OFFSET ELEMENT POINTER (3P)"
.SM "INQUIRE ELEMENT POINTER (3P)"
.SM "INQUIRE CURRENT ELEMENT TYPE AND SIZE (3P)"
.SM "SET ELEMENT POINTER AT LABEL (3P)"
.SM "SET ELEMENT POINTER AT PICK IDENTIFIER (3P+)"
.SM "ELEMENT SEARCH (3P)"
.fi
