SET ELEMENT POINTER AT PICK IDENTIFIER(3P+) — MISC. REFERENCE MANUAL PAGES

NAME

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

SYNOPSIS

C Syntax

void
psetelemptrpickid ( pick_id )
Pintpick_id;pick identifier

FORTRAN Syntax

SUBROUTINE psepid ( PKID )
INTEGERPKIDpick 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

PKIDSpecifies 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

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

Museum