Parallax BASIC Stamp 2e Programming Manual page 141

Table 5.17: I2CIN Conversion
Formatters.
5: BASIC Stamp Command Reference – I2CIN
Value VAR BYTE(13)
I2CIN 0, $A1, 0, [Value]
I2CIN 0, $A1, 0, [DEC Value]
I2CIN 0, $A1, 0, [HEX Value]
I2CIN 0, $A1, 0, [BIN Value]
I2CIN 0, $A1, 0, [STR Value\13]
Tables 5.17 and 5.18 list all the available conversion formatters and special
formatters available to the I2CIN command. See the SERIN command for
additional information and examples of their use.
Conversion Type of Number
Formatter
Decimal, optionally limited to 1 –
DEC{1..5}
Signed decimal, optionally
SDEC{1..5}
limited to 1 – 5 digits
Hexadecimal, optionally limited
HEX{1..4}
to 1 – 4 digits
SHEX{1..4} Signed hexadecimal, optionally
limited to 1 – 4 digits
Indicated hexadecimal,
IHEX{1..4}
optionally limited to 1 – 4 digits
Signed, indicated hexadecimal,
ISHEX{1..4}
optionally limited to 1 – 4 digits
Binary, optionally limited to
BIN{1..16}
1 – 16 digits
Signed binary, optionally limited
SBIN{1..16}
to 1 – 16 digits
Indicated binary, optionally
IBIN{1..16}
limited to 1 – 16 digits
Signed, indicated binary,
ISBIN{1..16}
optionally limited to 1 – 16 digits
1 All numeric conversions will continue to accept new data until receiving either the specified
number of digits (ex: three digits for DEC3) or a non-numeric character.
2 To be recognized as part of a number, the minus sign (-) must immediately precede a
numeric character. The minus sign character occurring in non-numeric text is ignored and
any character (including a space) between a minus and a number causes the minus to be
ignored.
3 The hexadecimal formatters are not case-sensitive; "a" through "f" means the same as "A"
through "F".
4 Indicated hexadecimal and binary formatters ignore all characters, even valid numerics,
until they receive the appropriate prefix ($ for hexadecimal, % for binary). The indicated
formatters can differentiate between text and hexadecimal (ex: ABC would be interpreted
by HEX as a number but IHEX would ignore it unless expressed as $ABC). Likewise, the
binary version can distinguish the decimal number 10 from the binary number %10. A
prefix occurring in non-numeric text is ignored, and any character (including a space)
between a prefix and a number causes the prefix to be ignored.
formatters require that the minus sign come before the prefix, as in -$1B45.
BASIC Stamp Programming Manual 2.0c • www.parallaxinc.com • Page 139
'receive the ASCII value for "V"
'receive the number 3.
'receive the number $3A.
'receive the number %101.
'receive the string "Value: 3A:101"
Numeric Characters Accepted
5 digits
0 through 9, A through F
-, 0 through 9, A through F
$, 0 through 9, A through F
-, $, 0 through 9, A through F
0 through 9
-, 0 through 9
1,2,3,4
0, 1
-, 0, 1
%, 0, 1
-, %, 0, 1
Indicated, signed
Notes
1
1,2
1,3
1,2,3
1,3,4
1
1,2
1,4
1,2,4