io microsphere collection EmptyIterable

EmptyIterable

Type: Class | Module: microsphere-java-core | Package: io.microsphere.collection | Since: 1.0.0

Source: microsphere-java-core/src/main/java/io/microsphere/collection/EmptyIterable.java

Overview

An empty Iterable implementation that always returns an empty iterator.

This class is a singleton-friendly extension of IterableAdapter, primarily useful for representing an empty collection view. It guarantees that the method #iterator() will return an instance of EmptyIterator#INSTANCE, ensuring consistent behavior across uses.

Example Usage

`Iterable emptyIterable = EmptyIterable.INSTANCE;
for (String item : emptyIterable) {
    // This loop will not execute as the iterable is empty.
`
}

Declaration

public class EmptyIterable<E> extends IterableAdapter<E>

Author: Mercy

Version Information

• Introduced in: 1.0.0
• Current Project Version: 0.1.10-SNAPSHOT

Version Compatibility

This component is tested and compatible with the following Java versions:

Java Version	Status
Java 8	✅ Compatible
Java 11	✅ Compatible
Java 17	✅ Compatible
Java 21	✅ Compatible
Java 25	✅ Compatible

Examples

Iterable<String> emptyIterable = EmptyIterable.INSTANCE;
for (String item : emptyIterable) {
    // This loop will not execute as the iterable is empty.
}

Usage

Maven Dependency

Add the following dependency to your pom.xml:

<dependency>
    <groupId>io.github.microsphere-projects</groupId>
    <artifactId>microsphere-java-core</artifactId>
    <version>${microsphere-java.version}</version>
</dependency>

Tip: Use the BOM (microsphere-java-dependencies) for consistent version management. See the Getting Started guide.

Import

import io.microsphere.collection.EmptyIterable;

See Also

• Iterable
• EmptyIterator

---

This documentation was auto-generated from the source code of microsphere-java.