Course contentsShow
← Java
Lesson 1533 of 2,87033. Streams API: Terminal OperationsFree lesson

anyMatch: Testing If Any Element Matches

Use anyMatch to check if at least one element in the stream satisfies the given predicate, returning true or false.

anyMatch: Testing If Any Element Matches

What you'll learn: How to use anyMatch to quickly check whether at least one element in your stream satisfies a condition.

What is anyMatch?

anyMatch is a terminal operation that tests whether any single element in the stream matches a given predicate. It returns true as soon as it finds the first matching element, and false if no elements match (or the stream is empty).

Think of it like asking, "Is there at least one person in this room wearing a red shirt?" You only need to spot one person to answer "yes"—you don't need to check everyone.

Basic Syntax

boolean anyMatch(Predicate<? super T> predicate)

The method takes a Predicate that defines your test condition.

Simple Examples

List<Integer> numbers = List.of(2, 4, 6, 8, 9);

boolean hasOdd = numbers.stream()
    .anyMatch(n -> n % 2 != 0);  // true (9 is odd)

boolean hasNegative = numbers.stream()
    .anyMatch(n -> n < 0);  // false (no negatives)

Short-Circuiting Behavior

anyMatch short-circuits: it stops processing as soon as it finds a match. If the first element matches, it won't even look at the rest. This makes it very efficient.

List<String> names = List.of("Alice", "Bob", "Charlie");

boolean startsWithB = names.stream()
    .anyMatch(name -> name.startsWith("B"));  // true, stops at "Bob"

Empty Streams

For an empty stream, anyMatch always returns false—there are no elements to match.

boolean result = Stream.empty().anyMatch(x -> true);  // false

Key Takeaway: Use anyMatch when you need to know if at least one element satisfies a condition; it efficiently short-circuits upon finding the first match, making it ideal for existence checks.