Function: list.prepend

Creates a copy of a list with a new element added to the beginning.

Arguments

Arguments
objs

list

The source list. Note that this list is not modified.

val

any

The element that will be prepended to the beginning.

Returns

A copy ofobjs withval added to the beginning.

Raised exceptions

Exceptions
TypeErrorIfobjs is not a list.

Examples

# Prepend `val` to start of copy of `my_list`# Returns `["three","zero","one","two"]`-init:assign:-my_list:["zero","one","two"]-val:"three"-returnStep:return:${list.prepend(my_list, val)}

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.