Lookdown - Parallax BASIC Stamp 2e Programming Manual

2
2
e
1
NOTE: Expressions are not
allowed as arguments on the BS1.
2
2
e
Table 5.35: LOOKDOWN Quick
Facts.
5: BASIC Stamp Command Reference – LOOKDOWN

LOOKDOWN

1
LOOKDOWN Target, ( Value0, Value1, ...ValueN ), Variable
2 2
LOOKDOWN Target, {ComparisonOp} [ Value0, Value1, ...ValueN ], Variable
sx p
Function
Compare Target value to a list of values and store the index number of the
first value that matches into Variable. If no value in the list matches,
Variable is left unaffected. On the BS2, BS2e, BS2sx and BS2p, the optional
ComparisonOp is used as criteria for the match; the default criteria is "equal
to."
• Target is a variable/constant/expression (0 – 65535) to be compared
to the values in the list.
2 2 • ComparisonOp is an optional comparison operator (as described in
sx p
Table 5.36) to be used as the criteria when comparing values. When
no ComparisonOp is specified, equal to (=) is assumed.
argument is not available on the BS1.
• Values are variables/constants/expressions (0 – 65535) to be
compared to Target.
• Variable is a variable (usually a byte) that will be set to the index (0 –
255) of the matching value in the Values list. If no matching value is
found, Variable is left unaffected.
Quick Facts
Limit of value
entries
Starting index
number
If value list
contains no
match...
Explanation
LOOKDOWN works like the index in a book. In an index, you search for a
topic and get the page number. LOOKDOWN searches for a target value
in a list, and stores the index number of the first match in a variable. For
example:
BS1 BS2 BS2e BS2sx BS2p
BS1, BS2, BS2e, BS2sx and BS2p
Variable is left unaffected
BASIC Stamp Programming Manual 2.0c • www.parallaxinc.com • Page 177
256
0
This