# 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

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. *bitPos*`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*