List.MatchesAny

Syntax

List.MatchesAny(list as list, condition as function) as logical

About

Returns true if the condition function is satisfied by any of the values in the list, otherwise returns false.

• list: The list containing the values to check.
• condition: The condition to check against the values in the list.

Example 1

Determine if any of the values in the list {9, 10, 11} are greater than 10.

Usage

List.MatchesAny({9, 10, 11}, each _  > 10)

Output

true

Example 2

Determine if any of the values in the list {1, 2, 3} are greater than 10.

Usage

List.MatchesAny({1, 2, 3}, each _  > 10)

Output

false

Example 3

Determine if any of the text values in the list contain "cat" while ignoring case.

Usage

let
    Source = {"A Brown Fox", "A Loyal Dog", "A Curious Cat", "A Wild Horse", "A Rascally Rabbit"},
    Result = List.MatchesAny(Source, each Text.Contains(_, "cat", Comparer.OrdinalIgnoreCase))
in
    Result

Output

true

Example 4

Determine if any of the dates contain the year 2021.

Usage

let
    Source = {#date(2024, 11, 28), #date(2023, 1, 14), #date(2021, 12, 31), #date(2025, 7, 6)},
    Result = List.MatchesAny(Source, each Date.Year(_) = 2021)
in
    Result

Output

true