Branch - Parallax BASIC Stamp 2e Programming Manual

2
2
e
1
NOTE: Expressions are not
allowed as arguments on the BS1.
Table 5.2: BRANCH Quick Facts.
1
BS1 syntax not shown here.
5: BASIC Stamp Command Reference - BRANCH

BRANCH

1
BRANCH Offset, ( Address0, Address1, ...AddressN )
2 2
BRANCH Offset, [ Address0, Address1, ...AddressN ]
sx p
Function
Go to the address specified by offset (if in range).
• Offset is a variable/constant/expression (0 – 255) that specifies the
index of the address, in the list, to branch to (0 – N).
• Addresses are labels that specify where to go. BRANCH will ignore
any list entries beyond offset 255.
Quick Facts
Limit of
Address
entries
Explanation
The BRANCH instruction is useful when you want to write something like
this:
IF value = 0 THEN case_0
IF value = 1 THEN case_1
IF value = 2 THEN case_2
You can use BRANCH to organize this into a single statement:
BRANCH value, [case_0, case_1, case_2]
This works exactly the same as the previous IF...THEN example. If the
value isn't in range (in this case if value is greater than 2), BRANCH does
nothing and the program continues with the next instruction after
BRANCH.
BRANCH can be teamed with the LOOKDOWN instruction to create a
simplified SELECT CASE statement. See LOOKDOWN for an example.
BS1 BS2 BS2e BS2sx BS2p
BS1
Limited only by memory
' value =0: go to label "case_0"
' value =1: go to label "case_1"
' value =2: go to label "case_2"
BASIC Stamp Programming Manual 2.0c • www.parallaxinc.com • Page 83
BS2, BS2e, BS2sx and BS2p
256