ee.List.get

  • Use List.get(index) to retrieve an element from a list at a specific position.

  • Negative indices count backwards from the end of the list to access elements.

  • The result of List.get is an ambiguous object type and needs to be cast to the expected type for further use.

 Returns the element at the specified position in list. A negative index counts backwards from the end of the list.

UsageReturns
List.get(index)Object
ArgumentTypeDetails
this: listList
indexInteger

Examples

Code Editor (JavaScript)

// An ee.List object.
var list = ee.List([5, 10, 15, 20, 25, 30]);

// Fetch elements at specified 0-based positions in the list.
print('The second element', list.get(1));
print('The fourth element', list.get(3));
print('The last element', list.get(-1));
print('The second to last element', list.get(-2));

// ee.Number and integer computed objects are valid inputs.
print('Computed object index input', list.get(list.get(0)));

// The result of ee.List.get is an ambiguous object type. You need to cast the
// result to the expected type to use it in subsequent instance methods. For
// example, if you are fetching a number and wish to add it to another number,
// you must cast the .get() result as an ee.Number.
print('Add fetched number to another number', ee.Number(list.get(1)).add(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)

# An ee.List object.
ee_list = ee.List([5, 10, 15, 20, 25, 30])

# Fetch elements at specified 0-based positions in the list.
display('The second element:', ee_list.get(1))
display('The fourth element:', ee_list.get(3))
display('The last element:', ee_list.get(-1))
display('The second to last element:', ee_list.get(-2))

# ee.Number and integer computed objects are valid inputs.
display('Computed object index input:', ee_list.get(ee_list.get(0)))

# The result of ee.List.get is an ambiguous object type. You need to cast the
# result to the expected type to use it in subsequent instance methods. For
# example, if you are fetching a number and wish to add it to another number,
# you must cast the .get() result as an ee.Number.
display('Add fetched number to another number:',
        ee.Number(ee_list.get(1)).add(2))