---
title: "bit_not"
url: https://una-lang.org/en/docs/std/builtin/bit_not/
release: v0.4.0
edition: "0.2 and later"
source: https://github.com/una-lang/una/blob/v0.4.0/docs/std/builtins.json
---

# bit_not

A built-in method, resolved by the type of its receiver ([`spec/14 §2`](https://una-lang.org/en/docs/spec/14-standard-library/#s2)). Edition 0.2 and later.

```una
a.bit_not() -> F
  where a: F, one of I8, I16, I32, I64, U8, U16, U32, U64
```

Total; its result is only known to be in the type's range (`spec/18 §5`).

## Receiver

- `F, one of I8, I16, I32, I64, U8, U16, U32, U64`: a fixed\-width integer `a`\, of one of the eight types `I8`\, `I16`\, `I32`\, `I64`\, `U8`\, `U16`\, `U32` and `U64`\; the result has its type

## Returns

`F`: each bit of `a` flipped\, on the two\'s\-complement bits of the width\; it never fails.

## See also

[`bit_and`](https://una-lang.org/en/docs/std/builtin/bit_and/), [`bit_or`](https://una-lang.org/en/docs/std/builtin/bit_or/), [`bit_xor`](https://una-lang.org/en/docs/std/builtin/bit_xor/)

## Example

`src/shop.una`

```una
module shop

--- Every bit of a value flipped, unsigned and signed.
pub main() -> Unit
  uses @console: Console[print]
=
  let empty: U8 = 0
  let full = empty.bit_not()
  let bottom: I8 = -128
  let top = bottom.bit_not()
  @console.print("{full}")
  @console.print("{top}")
```

`una run .` prints:

```text
255
127
```

## Specification

- [`spec/18 §5`](https://una-lang.org/en/docs/spec/18-fixed-width-integers/#s5)

Generated from una v0.4.0 ([`docs/std/builtins.json`](https://github.com/una-lang/una/blob/5fec93d88932b333feec25e589355a2cb34c37b5/docs/std/builtins.json), which is not part of the specification): built-in methods have no declaration, so una writes these signature lines and tests each against its checker. The specification governs: [`spec/14 §2`](https://una-lang.org/en/docs/spec/14-standard-library/#s2).
