docs-v2/content/flux/v0.x/stdlib/bitwise/uclear.md

3.7 KiB

title description menu weight
bitwise.uclear() function `bitwise.uclear()` performs the bitwise operation `a AND NOT b`, with unsigned integers.
flux_0_x_ref
name parent identifier
bitwise.uclear bitwise bitwise/uclear
101

bitwise.uclear() performs the bitwise operation a AND NOT b, with unsigned integers.

Function type signature
(a: uint, b: uint) => uint

{{% caption %}}For more information, see Function type signatures.{{% /caption %}}

Parameters

a

({{< req >}}) Left hand operand.

b

({{< req >}}) Bits to clear.

Examples

Perform a bitwise AND NOT operation

import "bitwise"

bitwise.uclear(a: uint(v: 1234), b: uint(v: 4567))// Returns 1024 (uint)


Perform a bitwise AND NOT operation on a stream of tables

import "bitwise"
import "sampledata"

sampledata.uint()
    |> map(fn: (r) => ({r with _value: bitwise.uclear(a: r._value, b: uint(v: 3))}))

{{< expand-wrapper >}} {{% expand "View example input and output" %}}

Input data

_time _value *tag
2021-01-01T00:00:00Z 18446744073709551614 t1
2021-01-01T00:00:10Z 10 t1
2021-01-01T00:00:20Z 7 t1
2021-01-01T00:00:30Z 17 t1
2021-01-01T00:00:40Z 15 t1
2021-01-01T00:00:50Z 4 t1
_time _value *tag
2021-01-01T00:00:00Z 19 t2
2021-01-01T00:00:10Z 4 t2
2021-01-01T00:00:20Z 18446744073709551613 t2
2021-01-01T00:00:30Z 19 t2
2021-01-01T00:00:40Z 13 t2
2021-01-01T00:00:50Z 1 t2

Output data

_time _value *tag
2021-01-01T00:00:00Z 18446744073709551612 t1
2021-01-01T00:00:10Z 8 t1
2021-01-01T00:00:20Z 4 t1
2021-01-01T00:00:30Z 16 t1
2021-01-01T00:00:40Z 12 t1
2021-01-01T00:00:50Z 4 t1
_time _value *tag
2021-01-01T00:00:00Z 16 t2
2021-01-01T00:00:10Z 4 t2
2021-01-01T00:00:20Z 18446744073709551612 t2
2021-01-01T00:00:30Z 16 t2
2021-01-01T00:00:40Z 12 t2
2021-01-01T00:00:50Z 0 t2

{{% /expand %}} {{< /expand-wrapper >}}