Parallax BASIC Stamp 2e, Programming Manual

Page: 185 / 353

5: BASIC Stamp Command Reference – LOOKUP
BASIC Stamp Programming Manual 2.0c
•
www.parallaxinc.com
•
Page 183
LOOKUP
BS1 BS2 BS2e BS2sx BS2p
LOOKUP Index, ( Value0, Value1, ...ValueN ), Variable
LOOKUP Index, [ Value0, Value1, ...ValueN ], Variable
Function
Find the value at location Index and store it in Variable. If Index exceeds the
highest index value of the items in the list, Variable is left unaffected.
• Index is a variable/constant/expression (0 – 255) indicating the list
item to retrieve.
•
Values
are variables/constants/expressions (0 – 65535).
• Variable is a variable that will be set to the value at the Index location.
If Index exceeds the highest location number, Variable is left
unaffected.
Quick Facts
BS1, BS2, BS2e, BS2sx and BS2p
Limit of value
entries
256
Starting index
number
0
If index
exceeds the
highest
location…
Variable is left unaffected
Explanation
LOOKUP retrieves an item from a list based on the item’s position, Index,
in the list. For example:
SYMBOL Index = B0
SYMBOL Result = B1
Index = 3
Result = 255
LOOKUP Index, (26, 177, 13, 1, 0, 17, 99), Result
DEBUG "Item ", #Index, "is: ", #Result
-- or --
1
2
e
2
sx
2
p
2
1
NOTE: Expressions are not
allowed as arguments on the BS1.
Table 5.38: LOOKUP Quick Facts.
1