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.

RealityV15.1Online Documentation (MoTW) Revision 7

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.