Package ch.nolix.coreapi.containerapi.commoncontainerapi

Schnittstelle SingleSearchable<E>

Typparameter:

E - is the type of the elements a SingleSearchable.

Alle bekannten Unterschnittstellen:

IArrayList<E>, ICachingContainer<E>, IContainer<E>, ILinkedList<E>, IMatrix<E>, ISqlRecord

Alle bekannten Implementierungsklassen:

ArrayList, ArrayView, CachingContainer, Container, ContainerView, ContainerView, FilterContainerView, ImmutableList, IterableView, LinkedList, Matrix, MatrixColumn, MatrixRow, MultiContainerView, SqlRecord

public interface SingleSearchable<E>

Version:

2024-11-12

Autor:

Silvan Wyss

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
Optional<E>	getOptionalStoredFirst()
Optional<E>	getOptionalStoredFirst(Predicate<? super E> selector)
E	getStoredAt1BasedIndex(int param1BasedIndex)
<C extends Comparable<C>> E	getStoredByMax(Function<E,C> comparableMapper)
<C extends Comparable<C>> E	getStoredByMin(Function<E,C> comparableMapper)
E	getStoredFirst()
E	getStoredFirst(Predicate<? super E> selector)
<E2 extends E> E2	getStoredFirstOfType(Class<E2> type)
E	getStoredLast()
E	getStoredOne()
E	getStoredOne(Predicate<? super E> selector)

Methodendetails

getOptionalStoredFirst

Optional<E> getOptionalStoredFirst()

Gibt zurück:

a Optional with the first element of the current SingleSearchable if the current SingleSearchable is not empty and if the first element of the current SingleSearchable is not null, an empty Optional otherwise.

getOptionalStoredFirst

Optional<E> getOptionalStoredFirst(Predicate<? super E> selector)

Parameter:

selector -

Gibt zurück:

a new Optional with the first element the given selector selects from the current SingleSearchable if the current SingleSearchable contains an element the given selector selects, an empty Optional otherwise. Ignores null elements.

Löst aus:

RuntimeException - if the given selector is null.

getStoredAt1BasedIndex

E getStoredAt1BasedIndex(int param1BasedIndex)

Parameter:

param1BasedIndex -

Gibt zurück:

the element at the given param1BasedIndex. The element can be null.

Löst aus:

RuntimeException - if the current SingleSearchable does not contain an element at the given param1BasedIndex.

getStoredByMax

<C extends Comparable<C>> E getStoredByMax(Function<E,C> comparableMapper)

Typparameter:

C - is the type of the Comparables the given comparableMapper maps from the elements of the current SingleSearchable.

Parameter:

comparableMapper -

Gibt zurück:

the element with the biggest Comparable the given comparableMapper maps from the elements of the current SingleSearchable. Ignores null elements.

Löst aus:

RuntimeException - if the given comparableMapper is null.

RuntimeException - if the current SingleSearchable does not contain a non-null element.

getStoredByMin

<C extends Comparable<C>> E getStoredByMin(Function<E,C> comparableMapper)

Typparameter:

C - is the type of the Comparables the given comparableMapper maps from the elements of the current SingleSearchable.

Parameter:

comparableMapper -

Gibt zurück:

the element with the smallest Comparable the given comparableMapper maps from the elements of the current SingleSearchable. Ignores null elements.

Löst aus:

RuntimeException - if the given comparableMapper is null.

RuntimeException - if the current SingleSearchable does not contain a non-null element.

getStoredFirst

E getStoredFirst()

Gibt zurück:

the first element of the current SingleSearchable. The element can be null.

Löst aus:

RuntimeException - if the current SingleSearchable is empty.

getStoredFirst

E getStoredFirst(Predicate<? super E> selector)

Parameter:

selector -

Gibt zurück:

the first element the given selector selects from the current SingleSearchable. Ignores null elements.

Löst aus:

RuntimeException - if the current SingleSearchable does not contain an element the given selector selects.

getStoredFirstOfType

<E2 extends E> E2 getStoredFirstOfType(Class<E2> type)

Typparameter:

E2 - is the given type.

Parameter:

type -

Gibt zurück:

the first element from the current SingleSearchable that is of the given type.

Löst aus:

RuntimeException - if the given type is null.

RuntimeException - if the current SingleSearchable does not contain an element of the given type.

getStoredLast

E getStoredLast()

Gibt zurück:

the last element of the current SingleSearchable. The element can be null.

Löst aus:

RuntimeException - if the current SingleSearchable is empty.

getStoredOne

E getStoredOne()

Gibt zurück:

the one element of the current SingleSearchable. The element can be null.

Löst aus:

RuntimeException - if the current SingleSearchable is empty.

RuntimeException - if the current SingleSearchable contains several elements.

getStoredOne

E getStoredOne(Predicate<? super E> selector)

Parameter:

selector -

Gibt zurück:

the one element the given selector selects from the current SingleSearchable. Ignores null elements.

Löst aus:

RuntimeException - if the given selector is null.

RuntimeException - if the given selector selects none or several elements from the current SingleSearchable.