ee.List.cat

AI-generated Key Takeaways

• 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.

Usage	Returns
List.cat(other)	List

Argument	Type	Details
this: list	List
other	List

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)

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

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

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

display(ee.List([]).cat(ee.List([])))  # []
display(ee.List([1]).cat(ee.List([])))  # [1]
display(ee.List([]).cat(ee.List([2])))  # [2]