Futurebasic/Language/Reference/bit
BitEdit
FunctionEdit
✔ Appearance ✔ Standard ✔ Console
SyntaxEdit
bitValue = bit( bitPos )
DescriptionEdit
This function returns an integer whose binary representation has the bit in position bitPos
set to "1", and all other bits set to "0". Bit positions are counted from right to left: a bitPos
value of zero corresponds to the rightmost ("least significant") bit. The maximum allowable value for bitPos
is 31, which corresponds to the leftmost bit in a long-integer value. bit
is useful in conjunction with "bitwise operators" like and
and or
, for setting and testing the values of particular bits in a quantity.
ExampleEdit
The following expression evaluates as _zTrue
(-1) if bit "n" is set in testValue&
:
( testValue& and bit( n ) ) <> 0
The following assignment sets bit "n" in testValue&
to 1:
testValue& = ( testValue& or bit( n ) )
The following assignment resets bit "n" in testValue&
to 0:
testValue& = ( testValue& and not bit( n ) )
NotesEdit
If _bitPos
is a symbolic constant name, then you can use _bitPos%
(note the "%") as a synonym for bit( _bitPos )
.
See AlsoEdit
bin$; and; or; not;
Appendix C: Data Types and Data Representation