Listable
✖
Listable
is an attribute that can be assigned to a symbol to indicate that the function
should automatically be threaded over lists that appear as its arguments.
Details

- Listable functions are effectively applied separately to each element in a list, or to corresponding elements in each list if there is more than one list.
- Most built‐in mathematical functions are Listable. »
- All the arguments which are lists in a Listable function must be of the same length. »
- Arguments that are not lists are copied as many times as there are elements in the lists.
Examples
open allclose allBasic Examples (4)Summary of the most common use cases
A Listable function threads over its list argument:

https://wolfram.com/xid/0c13m12-h38w0c

Log is listable:

https://wolfram.com/xid/0c13m12-ctggjq


https://wolfram.com/xid/0c13m12-qvpc9

Listable functions combine corresponding elements:

https://wolfram.com/xid/0c13m12-gu23md

Arguments that are not lists are replicated as needed:

https://wolfram.com/xid/0c13m12-ehmrjx


https://wolfram.com/xid/0c13m12-bz4e3m

Scope (4)Survey of the scope of standard use cases
Define a function to be listable:

https://wolfram.com/xid/0c13m12-dtrukr

https://wolfram.com/xid/0c13m12-fickm

Most built-in mathematical functions are listable:

https://wolfram.com/xid/0c13m12-b2w650


https://wolfram.com/xid/0c13m12-catk4o


https://wolfram.com/xid/0c13m12-nczuo

Listability works for any nesting depth of lists:

https://wolfram.com/xid/0c13m12-ccjanf

The nesting level of the different arguments need not be the same:

https://wolfram.com/xid/0c13m12-dds0hf

Listability works on other list-like constructs such as SparseArray:

https://wolfram.com/xid/0c13m12-phq00

https://wolfram.com/xid/0c13m12-cmnlix


https://wolfram.com/xid/0c13m12-hzpkyl

Applications (2)Sample problems that can be solved with this function
To apply a function to a vector, take advantage of Listable functions when possible:

https://wolfram.com/xid/0c13m12-dswo1c
Use the listability of Plus, Power, Sin, and Times:

https://wolfram.com/xid/0c13m12-ntnimy

Use Map:

https://wolfram.com/xid/0c13m12-mcjqr

Use Table:

https://wolfram.com/xid/0c13m12-k1xix

Use Table and Part to access elements of v as might be done in a lower-level language:

https://wolfram.com/xid/0c13m12-d9dc57

The results are the same up to numerical roundoff:

https://wolfram.com/xid/0c13m12-b6318u

Use efficient sparse arithmetic to numerically solve the heat equation :

https://wolfram.com/xid/0c13m12-cj8ngh
Matrix for a second-order approximation to the second derivative on the grid :

https://wolfram.com/xid/0c13m12-bq4ydk

Incorporate Dirichlet boundary conditions to form the Jacobian J:

https://wolfram.com/xid/0c13m12-ipuq80


https://wolfram.com/xid/0c13m12-eeks5z

Form sparse matrix for
using the listability of arithmetic:

https://wolfram.com/xid/0c13m12-8drtt

LU decomposition of in a functional form:

https://wolfram.com/xid/0c13m12-k7ochh

Step initial condition on spatial grid x using the listability of UnitStep:

https://wolfram.com/xid/0c13m12-cwn40b

Get the solution at ,
using the backward Euler method:

https://wolfram.com/xid/0c13m12-etuzya

https://wolfram.com/xid/0c13m12-d4rrko

Properties & Relations (7)Properties of the function, and connections to other functions
Listable, in general, functions effectively apply Thread many times:

https://wolfram.com/xid/0c13m12-dw3x7z

https://wolfram.com/xid/0c13m12-co63il


https://wolfram.com/xid/0c13m12-du9bqf


https://wolfram.com/xid/0c13m12-mpavw

Applying listable functions to several arrays of equal dimension is equivalent to using MapThread:

https://wolfram.com/xid/0c13m12-ji2trt

https://wolfram.com/xid/0c13m12-bsdevj

https://wolfram.com/xid/0c13m12-bc3g5r

Listable functions applied to several arrays require overlapping dimensions to be equal:

https://wolfram.com/xid/0c13m12-cyrrzv
Arguments with equal dimensions:

https://wolfram.com/xid/0c13m12-drrkll

Arguments with equal overlapping dimensions, i.e. {2} has the same leading dimensions as {2,3}:

https://wolfram.com/xid/0c13m12-fgmqd0

Arguments with unequal overlapping dimensions, i.e. {2} does not have the same leading dimensions as {3,2}:

https://wolfram.com/xid/0c13m12-dwn33c

Listable functions applied to arrays can be written as a Table:

https://wolfram.com/xid/0c13m12-clzwt

https://wolfram.com/xid/0c13m12-faij6

https://wolfram.com/xid/0c13m12-c06y0o

A function implemented in terms of a listable operation may not need the Listable attribute:

https://wolfram.com/xid/0c13m12-d125ig

https://wolfram.com/xid/0c13m12-jh7t84


https://wolfram.com/xid/0c13m12-eyyo3y

The system symbols with the Listable attribute:

https://wolfram.com/xid/0c13m12-bsbmeh

More than half these are arithmetic functions possessing the NumericFunction attribute as well:

https://wolfram.com/xid/0c13m12-g5t8zo

The products given by Dot, Times, and KroneckerProduct are inner, element-wise, and outer:

https://wolfram.com/xid/0c13m12-bbwg89
The inner product of two vectors:

https://wolfram.com/xid/0c13m12-c6ckpa

The vector resulting from the product of corresponding elements:

https://wolfram.com/xid/0c13m12-kw4s9w

The matrix resulting from the outer product of the vectors:

https://wolfram.com/xid/0c13m12-bnfyvi

Wolfram Research (1988), Listable, Wolfram Language function, https://reference.wolfram.com/language/ref/Listable.html.
Text
Wolfram Research (1988), Listable, Wolfram Language function, https://reference.wolfram.com/language/ref/Listable.html.
Wolfram Research (1988), Listable, Wolfram Language function, https://reference.wolfram.com/language/ref/Listable.html.
CMS
Wolfram Language. 1988. "Listable." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Listable.html.
Wolfram Language. 1988. "Listable." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Listable.html.
APA
Wolfram Language. (1988). Listable. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Listable.html
Wolfram Language. (1988). Listable. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Listable.html
BibTeX
@misc{reference.wolfram_2025_listable, author="Wolfram Research", title="{Listable}", year="1988", howpublished="\url{https://reference.wolfram.com/language/ref/Listable.html}", note=[Accessed: 13-April-2025
]}
BibLaTeX
@online{reference.wolfram_2025_listable, organization={Wolfram Research}, title={Listable}, year={1988}, url={https://reference.wolfram.com/language/ref/Listable.html}, note=[Accessed: 13-April-2025
]}