Enable JavaScript to interact with content and submit forms on Wolfram websites. Learn how

Wolfram Language & System Documentation Center

BlankNullSequence

BlankNullSequence

___ (three _ characters) or BlankNullSequence[]

is a pattern object that can stand for any sequence of zero or more Wolfram Language expressions.

___h or BlankNullSequence[h]

can stand for any sequence of expressions, all of which have head h.

Details

Blank sequences work slightly differently depending on whether or not the head of the expression in which they appear is a symbol with the attribute Flat.
Consider matching the pattern f[a₁,a₂,…,___,c₁,…] against the expression f[a₁,a₂,…,b₁,…,c₁,…]. If f is a symbol with attribute Flat, then the ___ will be taken to stand for the expression f[b₁,…]. If f is not a symbol with attribute Flat, then ___ will be taken to stand for the sequence of expressions b₁, …. With a named pattern, such as x___, x can be used only as an element in an expression. The sequence of expressions b₁, … is "spliced in" to replace x, thereby usually increasing the length of the expression.
If ___ matches a sequence of length more than one, then the sequence will be represented by a Sequence object. In most uses of ___, however, the Sequence object will automatically be spliced into another expression, and will never appear explicitly.

Examples

Basic Examples (3)

A function that works with any number of arguments:

A function that works with any number of integer arguments:

A function that works with an integer followed by any number of arguments:

Top