ee.List.cat

  • The List.cat(other) method concatenates the contents of another list onto the end of the current list.

  • Both the this list and the other list must be of type List.

  • The method returns a new List containing the concatenated elements.

  • Examples demonstrate concatenating lists with various elements, including nested lists and empty lists.

 Concatenates the contents of other onto list.

UsageReturns
List.cat(other)List
ArgumentTypeDetails
this: listList
otherList

Examples

Code Editor (JavaScript)

print(ee.List(['dog']).cat(['squirrel']));  // ["dog","squirrel"]
print(ee.List(['moose']).cat(['&', 'squirrel']));  // ["moose","&","squirrel"]

print(ee.List([['a', 'b']]).cat(ee.List([['1', 1]])));  // [["a","b"],["1",1]]

print(ee.List([]).cat(ee.List([])));  // []
print(ee.List([1]).cat(ee.List([])));  // [1]
print(ee.List([]).cat(ee.List([2])));  // [2]

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)

print(ee.List(['dog']).cat(['squirrel']).getInfo())  # ['dog', 'squirrel']

# ['moose', '&', 'squirrel']
print(ee.List(['moose']).cat(['&', 'squirrel']).getInfo())

# [['a', 'b'], ['1', 1]]
print(ee.List([['a', 'b']]).cat(ee.List([['1', 1]])).getInfo())

print(ee.List([]).cat(ee.List([])).getInfo())  # []
print(ee.List([1]).cat(ee.List([])).getInfo())  # [1]
print(ee.List([]).cat(ee.List([2])).getInfo())  # [2]