ee.Array.bitwiseNot

  • Array.bitwiseNot() calculates the bitwise NOT of each element in an input array, using the smallest signed integer type that can accommodate the input values.

  • The function returns a new array containing the results of the bitwise NOT operation on each corresponding element of the input array.

  • The bitwise NOT operation inverts the bits of each element, essentially changing 0s to 1s and 1s to 0s within the binary representation of the numbers.

  • This operation is performed on an element-by-element basis, meaning that the bitwise NOT is applied individually to each value within the input array.

  • If the input array is empty, an empty array will be returned.

 On an element-wise basis, calculates the bitwise NOT of the input, in the smallest signed integer type that can hold the input.

UsageReturns
Array.bitwiseNot()Array
ArgumentTypeDetails
this: inputArrayThe input array.

Examples

Code Editor (JavaScript)

var empty = ee.Array([], ee.PixelType.int8());
print(empty.bitwiseNot());  // []

print(ee.Array(0).bitwiseNot());  // -1
print(ee.Array(1).bitwiseNot());  // -2
print(ee.Array(0xFF).bitwiseNot());  // -256

print(ee.Array(-1).bitwiseNot());  // 0
print(ee.Array(-2).bitwiseNot());  // 1
print(ee.Array(-3).bitwiseNot());  // 2

print(ee.Array(0xFF).toInt64().bitwiseNot());  // -256

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

empty = ee.Array([], ee.PixelType.int8())
display(empty.bitwiseNot())  # []

display(ee.Array(0).bitwiseNot())  # -1
display(ee.Array(1).bitwiseNot())  # -2
display(ee.Array(0xFF).bitwiseNot())  # -256

display(ee.Array(-1).bitwiseNot())  # 0
display(ee.Array(-2).bitwiseNot())  # 1
display(ee.Array(-3).bitwiseNot())  # 2

display(ee.Array(0xFF).toInt64().bitwiseNot())  # -256