AllMatch

✖
`AllMatch`

New in 14.1

✖

AllMatch[{e₁,e₂,…},form]

yields True if e_i matches the pattern form for all of the e_i.

✖

AllMatch[expr,form,level]

tests parts of expr at level level.

✖

AllMatch[form]

represents an operator form of AllMatch that can be applied to an expression.

Details

AllMatch[expr,form] and AllMatch[expr,form,level] only test as many e_i as are necessary to determine the result. »
AllMatch[list,form] is equivalent to AllMatch[list,form,1].
AllMatch works on associations, testing values but not keys. »
AllMatch[form][list] is equivalent to AllMatch[list,form].

Examples

open allclose all

Basic Examples (4)Summary of the most common use cases

Check if all elements of a list match a pattern:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-hloes3

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0j44sc5y-yk02xe

Out[2]=2

Check if all elements of a matrix match a pattern:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-72splg

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0j44sc5y-hp7jlh

Out[2]=2

Use the operator form of AllMatch:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-tul23i

Out[1]=1

Check if all values of an association match a pattern:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-tc0rpv

Out[1]=1

Scope (4)Survey of the scope of standard use cases

AllMatch may be applied to expressions with any head:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-satqk5

Out[1]=1

AllMatch can operate on ragged expressions:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-nrxatk

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0j44sc5y-ddim4r

Out[2]=2

By default, AllMatch operates at level 1:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-5ywwwt

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0j44sc5y-q7tlwz

Out[2]=2

In[3]:=3

✖

https://wolfram.com/xid/0j44sc5y-u8d8qa

Out[3]=3

Use Verbatim to test for a literal blank:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-h6rxbu

Out[1]=1

Properties & Relations (6)Properties of the function, and connections to other functions

AllMatch[list,form] is equivalent to NoneMatch[list,Except[form]]:

In[2]:=2

✖

https://wolfram.com/xid/0j44sc5y-tbjgd

Out[2]=2

AllMatch[list,form] works efficiently on sparse vectors:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-x83x7f

Out[1]=1

AllMatch[list,form] checks the parts of list in order, stopping as soon as form does not match:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-5rcria

Out[1]=1

AllMatch[list,form] is equivalent to AllTrue[list,MatchQ[form]]:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-emx8zk

Out[1]=1

AllMatch[{e₁,e₂,…},form] is equivalent to And[MatchQ[e₁,form],MatchQ[e₂,form],…]:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-y3s4u0

Out[1]=1

AllMatch[list,e₁|e₂|…] is equivalent to ContainsOnly[list,{e₁,e₂,…}]:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-8ker9e

Out[1]=1

Possible Issues (1)Common pitfalls and unexpected behavior

For associations, AllMatch tests only values:

In[1]:=1

✖

https://wolfram.com/xid/0j44sc5y-zo8sjm

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0j44sc5y-8iz31t

Out[2]=2

Top