AI-generated Key Takeaways
-
The
splicemethod removes a specified number of elements from a list starting at a given index and can optionally insert elements from another list at that location. -
A negative
startvalue counts backwards from the end of the list. -
The method returns the modified list.
| Usage | Returns |
|---|---|
List.
splice
(start, count, other
)
|
List |
| Argument | Type | Details |
|---|---|---|
|
this:
list
|
List | |
start
|
Integer | |
count
|
Integer | |
other
|
List, default: null |
Examples
Code Editor (JavaScript)
// An ee.List object. var list = ee . List ([ 0 , 1 , 2 , 3 , 4 ]); print ( 'Original list' , list ); // If "other" argument is null, elements at positions specified by "start" and // "count" are deleted. Here, the 3rd element is removed. print ( 'Remove 1 element' , list . splice ({ start : 2 , count : 1 , other : null })); // If "start" is negative, the position is from the end of the list. print ( 'Remove 2nd from last element' , list . splice ( - 2 , 1 )); // Deletes 3 elements starting at position 1. print ( 'Remove multiple sequential elements' , list . splice ( 1 , 3 )); // Insert elements from the "other" list without deleting existing elements // by specifying the insert "start" position and setting "count" to 0. print ( 'Insert new elements' , list . splice ( 2 , 0 , [ 'X' , 'Y' , 'Z' ])); // Replace existing elements with those from the "other" list by specifying the // "start" position to replace and the "count" of proceeding elements. If // length of "other" list is greater than "count", the remaining "other" // elements are inserted, they do not replace existing elements. print ( 'Replace elements' , list . splice ( 2 , 3 , [ 'X' , 'Y' , 'Z' ]));
import ee import geemap.core as geemap
Colab (Python)
# An ee.List object. ee_list = ee . List ([ 0 , 1 , 2 , 3 , 4 ]) display ( 'Original list:' , ee_list ) # If "other" argument is None, elements at positions specified by "start" and # "count" are deleted. Here, the 3rd element is removed. display ( 'Remove 1 element:' , ee_list . splice ( start = 2 , count = 1 , other = None )) # If "start" is negative, the position is from the end of the list. display ( 'Remove 2nd from last element:' , ee_list . splice ( - 2 , 1 )) # Deletes 3 elements starting at position 1. display ( 'Remove multiple sequential elements:' , ee_list . splice ( 1 , 3 )) # Insert elements from the "other" list without deleting existing elements # by specifying the insert "start" position and setting "count" to 0. display ( 'Insert new elements:' , ee_list . splice ( 2 , 0 , [ 'X' , 'Y' , 'Z' ])) # Replace existing elements with those from the "other" list by specifying the # "start" position to replace and the "count" of proceeding elements. If # length of "other" list is greater than "count", the remaining "other" # elements are inserted, they do not replace existing elements. display ( 'Replace elements:' , ee_list . splice ( 2 , 3 , [ 'X' , 'Y' , 'Z' ]))
