Proc Reference > TCL Commands Related to Proc > PQ-SELECT

Comment on this topic

Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

PQ-SELECT (Proc) (m618404+pqselect.htm)

To

Reality

Version

Topic

Submitted by

Company

Location

Email address

Comment

 

 

PQ-SELECT

Executed from a Proc, loads a list of item-ids into a select register.

Syntax

PQ-SELECT register-number

Syntax Elements

register-number is the number of the select register (1 to 47) in which the item-ids are to be placed.

Comments

To process a selected list generated within a Proc, PQ-SELECT must be placed in the stack.

The item list processed by PQ-SELECT can be obtained as the result of the execution of a SELECT command, or of any other TCL (or English) command that generates an active list. Refer to Select Registers for a complete list of commands that generate an active list.

Item-ids are referenced one at a time, using a !n direct or indirect reference.

This command cannot be executed directly at TCL.

An example showing the use of PQ-SELECT in conjunction with the Proc command IF S is included in the description of that command.

Example

001 PQN
002 HSSELECT BLOCK-CONVERT
003 STON
004 HPQ-SELECT 1
005 P
006 10 MV %1 !1
007 IF %1 = "" X
008 T %1
009 GO 10

This example selects all the items in the BLOCK-CONVERT file, loads the item-list into select register 1 and displays them one at a time.

RealityV15.0Comment on this topic