NAME

SET ELEMENT POINTER AT PICK IDENTIFIER - set the element pointer to the next occurrence of the specified pick identifier

SYNOPSIS

C Syntax

void

pset_elem_ptr_pick_id ( pick_id )

Pint

pick_id;

pick identifier

FORTRAN Syntax

SUBROUTINE psepid ( PKID )

INTEGER

PKID

pick identifier

Required PHIGS Operating States

(PHOP, * ,STOP, * )

DESCRIPTION

Purpose

SET ELEMENT POINTER AT PICK IDENTIFIER sets the element pointer of the currently open structure to the next occurrence in the structure of an element containing the specified pick identifier. Pick identifier structure elements are created by the SET PICK IDENTIFIER subroutine.

This is a SunPHIGS Extension function based on customer requests and is not part of the PHIGS standard.

C Input Parameter

pick_id Specifies the pick identifier in the open structure at which to set the element

pointer.

FORTRAN Input Parameter

PKID

Specifies the pick identifier in the open structure at which to set the element pointer.

Execution

SET ELEMENT POINTER AT PICK IDENTIFIER searches for the pick identifier from the structure element following the current element pointer to the end of the open structure. If an occurrence of pick identifier is not found between the current element pointer and the end of the structure, the subroutine does not move the element pointer and generates an error.

ERRORS

-154

SunPHIGS-dependent: Ignoring function, the pick identifier does not exist in the open structure between the element pointer and the end of the structure

SEE ALSO

OFFSET ELEMENT POINTER (3P)

INQUIRE ELEMENT POINTER (3P)

INQUIRE CURRENT ELEMENT TYPE AND SIZE (3P)

SET ELEMENT POINTER (3P)

SET ELEMENT POINTER AT LABEL (3P)

ELEMENT SEARCH (3P)