English Reference > List Processing Commands > OR-ITEMS

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 ()

OR-ITEMS Command (English) (m618305+oritems.htm)

To

Reality

Version

Topic

Submitted by

Company

Location

Email address

Comment

 

 

OR-ITEMS

Returns a list comprising one copy of any value contained in any of two or more items, that is, the union of the values.

Syntax

OR-ITEMS file-specifier {item-list} {(options}

Syntax Elements

file-specifier Specifies a file as defined in General Conventions.

item-list A list of item-ids or an asterisk (*) for all items. Can be omitted there is an active list from a preceding list-generating command.

Options

I Specifies that case should be ignored when comparing attribute values.

S Specifies that case is significant when comparing attribute values.

Comments

Only the first field (value or subvalue) is processed, all the other fields being discarded. The merged list therefore contains only the first field from each attribute.

Case Sensitivity

If neither I nor S is specified, the current data case setting (set with the DATA.CC environment option or the CASE TCL command) is used. See Case Sensitivity for more details.

If both I and S are specified an error message is displayed and no list is generated.

Examples

:OR-ITEMS BOOKS SHIPS PIRATES
42 Items selected.
>SAVE-LIST SPLIST
[241] 'SPLIST' Cataloged.

All values that were in either item SHIPS or PIRATES in file BOOKS are now in list SPLIST.

:OR-ITEMS POISONS CRAMPS SWEAT NUMBNESS
37 Items selected.
>SAVE-LIST MSW
[241] 'MSW' Cataloged.

The list in MSW contains all values that were in any item CRAMPS, SWEAT, or NUMBNESS in file POISONS.

RealityV15.0Comment on this topic