Package Torello.Java.ReadOnly

Interface ReadOnlySequencedCollection<E>

Type Parameters:

E - the type of elements in this collection

All Superinterfaces:

java.lang.Iterable<E>, ReadOnlyCollection<E>

All Known Subinterfaces:

ReadOnlyNavigableSet<E>, ReadOnlySequencedSet<E>, ReadOnlySortedSet<E>

All Known Implementing Classes:

ReadOnlyTreeSet

public interface ReadOnlySequencedCollection<E>
extends ReadOnlyCollection<E>

This interface was originally copied from GitHub's Open-JDK Account. Though the original file has been modified, few changes have been applied to the Javadoc Commenting. Due to fact that that is a Java interface file, there were few method bodies with Source-Code to begin with - meaning this is largely a copy of Method-Signatures and Java-Doc Comments.

Method and parameter names & types have not been modified whatsoever; but several methods had to be eliminated for not being Read-Only. This Source-File was copied from the original Open JDK-21 file of the same (or, rather, highly similar) Interface-Name. The original file may be viewed on the JDK-21 GitHub public (and, coincidentally, Read-Only) Source-Release archive for Java Package java.util.*

The Original '.java' Source-File's Header-Copyright Information is included here: File Copyright. Within that Copyright Notice, it is suggested that a copy of the GNU Public License V2 also be included alongside.

Immutable variant of Java Collections Framework interface java.util.SequencedCollection<E>. This interface contains all of the methods that the standard Java interface ReadOnlySequencedCollection contains - except those which would directly or indirectly modify / mutate the internal data-structure.

Hi-Lited Source-Code:

• View Here: Torello/Java/ReadOnly/ReadOnlySequencedCollection.java
• Open New Browser-Tab: Torello/Java/ReadOnly/ReadOnlySequencedCollection.java

File Size: 3,802 Bytes Line Count: 85 '\n' Characters Found

Method Summary

Retrieve a Reverse-Ordered Set
Modifier and Type	Method
ReadOnlySequencedCollection<E>	reversed()
Default Methods (Interface Methods with a Concrete, Default Implementation)
Modifier and Type	Method
default E	getFirst()
default E	getLast()

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface Torello.Java.ReadOnly.ReadOnlyCollection

contains, containsAll, containsAND, containsAND, containsNAND, containsNAND, containsOR, containsOR, containsXOR, containsXOR, copyIntoCollection, equals, hashCode, isEmpty, iterator, parallelStream, size, spliterator, stream, toArray, toArray, toArray

Method Detail

reversed

🡇 ⇈ ⮫ 🗕 🗗 🗖

ReadOnlySequencedCollection<E> reversed()

Returns a reverse-ordered view of this collection. The encounter order of elements in the returned view is the inverse of the encounter order of elements in this collection. The reverse ordering affects all order-sensitive operations, including those on the view collections of the returned view.

Returns:

a reverse-ordered view of this collection

getFirst

🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖

default E getFirst()

Gets the first element of this collection.

Returns:

the retrieved element

Throws:

NoSuchElementException - if this collection is empty

Code:

Exact Method Body:

 return this.iterator().next();

getLast

🡅 ⇈ ⮫ 🗕 🗗 🗖

default E getLast()

Gets the last element of this collection.

Returns:

the retrieved element

Throws:

NoSuchElementException - if this collection is empty

Code:

Exact Method Body:

 return this.reversed().iterator().next();