A set of macros that perform calculations on bits.
The macros in this module come in two flavors: named or operators. For example:
iex> use Bitwise iex> bnot(1) # named -2 iex> 1 &&& 1 # operator 1
If you prefer to use only operators or skip them, you can pass the following options:
:only_operators
- includes only operators :skip_operators
- skips operators For example:
iex> use Bitwise, only_operators: true iex> 1 &&& 1 1
When invoked with no options, use Bitwise
is equivalent to import Bitwise
.
All bitwise macros can be used in guards:
iex> use Bitwise iex> odd? = fn ...> int when band(int, 1) == 1 -> true ...> _ -> false ...> end iex> odd?.(1) true
Infix operator; calculates the bitwise AND of its arguments.
Infix operator; calculates the result of an arithmetic left bitshift.
Infix operator; calculates the result of an arithmetic right bitshift.
Infix operator; calculates the bitwise XOR of its arguments.
Calculates the bitwise AND of its arguments.
Calculates the bitwise NOT of its argument.
Calculates the bitwise OR of its arguments.
Calculates the result of an arithmetic left bitshift.
Calculates the result of an arithmetic right bitshift.
Calculates the bitwise XOR of its arguments.
Infix operator; calculates the bitwise OR of its arguments.
Prefix (unary) operator; calculates the bitwise NOT of its argument.
Infix operator; calculates the bitwise AND of its arguments.
iex> 9 &&& 3 1
Infix operator; calculates the result of an arithmetic left bitshift.
iex> 1 <<< 2 4 iex> 1 <<< -2 0 iex> -1 <<< 2 -4 iex> -1 <<< -2 -1
Infix operator; calculates the result of an arithmetic right bitshift.
iex> 1 >>> 2 0 iex> 1 >>> -2 4 iex> -1 >>> 2 -1 iex> -1 >>> -2 -4
Infix operator; calculates the bitwise XOR of its arguments.
iex> 9 ^^^ 3 10
Calculates the bitwise AND of its arguments.
iex> band(9, 3) 1
Calculates the bitwise NOT of its argument.
iex> bnot(2) -3 iex> bnot(2) &&& 3 1
Calculates the bitwise OR of its arguments.
iex> bor(9, 3) 11
Calculates the result of an arithmetic left bitshift.
iex> bsl(1, 2) 4 iex> bsl(1, -2) 0 iex> bsl(-1, 2) -4 iex> bsl(-1, -2) -1
Calculates the result of an arithmetic right bitshift.
iex> bsr(1, 2) 0 iex> bsr(1, -2) 4 iex> bsr(-1, 2) -1 iex> bsr(-1, -2) -4
Calculates the bitwise XOR of its arguments.
iex> bxor(9, 3) 10
Infix operator; calculates the bitwise OR of its arguments.
iex> 9 ||| 3 11
Prefix (unary) operator; calculates the bitwise NOT of its argument.
iex> ~~~2 -3 iex> ~~~2 &&& 3 1
© 2012 Plataformatec
Licensed under the Apache License, Version 2.0.
https://hexdocs.pm/elixir/1.9.1/Bitwise.html