Gambas Documentation - /lang/bclr

# BClr

Value = BClr ( Number , Bit )

Return Number with its Bitth bit cleared. The bit number of the least significant bit is 0.

The type of Number may be Byte, Short, Integer, or Long.

The valid range of Bit depends on the type of the Number argument.

Type of Number | Range of Bit
--- | ---
Byte | 0...7
Short | 0...15
Integer | 0...31
Long | 0...63

The datatype of the return value is the datatype of Number.

### Errors

Message | Description
--- | ---
Type mismatch (6) | The datatype of the Number argument is not valid.
Bad argument (20) | The Bit argument is out of range.

### Examples

    Print 15, Bin(15, 16)
    Print BClr(15, 1), Bin(BClr(15, 1), 16)

    15      0000000000001111
    13      0000000000001101

    Print 13, Bin(13, 16)
    Print BClr(13, 1), Bin(BClr(13, 1), 16)

    13      0000000000001101
    13      0000000000001101

### See also

- Bits Manipulation Functions

- Logical Operators