org.jenetics.util

Interface ISeq<T>

All Superinterfaces:

Copyable<MSeq<T>>, Iterable<T>, Seq<T>

All Known Implementing Classes:

ArrayProxyISeq, CharSeq

public interface ISeq<T>
extends Seq<T>, Copyable<MSeq<T>>

Immutable, ordered, fixed sized sequence.

Since:

1.0

Version:

3.0 — $Date: 2014-12-28 $

Author:

Franz Wilhelmstötter

See Also:

MSeq

Method Summary

Modifier and Type	Method and Description
MSeq<T>	copy() Return a shallow copy of this sequence.
<B> ISeq<B>	map(Function<? super T,? extends B> mapper) Builds a new sequence by applying a function to all elements of this sequence.
static <T> ISeq<T>	of(Iterable<? extends T> values) Create a new ISeq from the given values.
static <T> ISeq<T>	of(Supplier<? extends T> supplier, int length)
static <T> ISeq<T>	of(T... values) Create a new ISeq from the given values.
ISeq<T>	subSeq(int start) Returns a view of the portion of this sequence between the specified start, inclusive, and end, exclusive.
ISeq<T>	subSeq(int start, int end) Returns a view of the portion of this sequence between the specified start, inclusive, and end, exclusive.
static <T> Collector<T,?,ISeq<T>>	toISeq() Returns a Collector that accumulates the input elements into a new ISeq.

Methods inherited from interface org.jenetics.util.Seq

asList, contains, equals, equals, forAll, get, hashCode, hashCode, indexOf, indexOf, indexOf, indexWhere, indexWhere, indexWhere, isSorted, isSorted, lastIndexOf, lastIndexOf, lastIndexOf, lastIndexWhere, lastIndexWhere, lastIndexWhere, length, parallelStream, size, spliterator, stream, toArray, toArray, toSeq, toString, toString

Methods inherited from interface java.lang.Iterable

forEach, iterator

Method Detail

subSeq

ISeq<T> subSeq(int start,
               int end)

Description copied from interface: Seq

Returns a view of the portion of this sequence between the specified start, inclusive, and end, exclusive. (If start and end are equal, the returned sequence has the length zero.) The returned sequence is backed by this sequence, so non-structural changes in the returned sequence are reflected in this array, and vice-versa.

This method eliminates the need for explicit range operations (of the populationSort that commonly exist for arrays). Any operation that expects an array can be used as a range operation by passing an sub sequence view instead of an whole sequence.

Specified by:

subSeq in interface Seq<T>

Parameters:

start - low end point (inclusive) of the sub sequence.

end - high end point (exclusive) of the sub sequence.

Returns:

a view of the specified range within this sequence.

subSeq

ISeq<T> subSeq(int start)

Description copied from interface: Seq

Returns a view of the portion of this sequence between the specified start, inclusive, and end, exclusive. (If start and end are equal, the returned sequence has the length zero.) The returned sequence is backed by this sequence, so non-structural changes in the returned sequence are reflected in this sequence, and vice-versa.

This method eliminates the need for explicit range operations (of the populationSort that commonly exist for arrays). Any operation that expects an sequence can be used as a range operation by passing an sub sequence view instead of an whole sequence.

Specified by:

subSeq in interface Seq<T>

Parameters:

start - low end point (inclusive) of the sub array.

Returns:

a view of the specified range within this array.

map

<B> ISeq<B> map(Function<? super T,? extends B> mapper)

Description copied from interface: Seq

Builds a new sequence by applying a function to all elements of this sequence.

Specified by:

map in interface Seq<T>

Type Parameters:

B - the element type of the returned collection.

Parameters:

mapper - the function to apply to each element.

Returns:

a new sequence of type That resulting from applying the given function f to each element of this sequence and collecting the results.

copy

MSeq<T> copy()

Return a shallow copy of this sequence. The sequence elements are not cloned.

Specified by:

copy in interface Copyable<MSeq<T>>

Returns:

a shallow copy of this sequence.

toISeq

static <T> Collector<T,?,ISeq<T>> toISeq()

Returns a Collector that accumulates the input elements into a new ISeq.

Type Parameters:

T - the type of the input elements

Returns:

a Collector which collects all the input elements into an ISeq, in encounter order

of

@SafeVarargs
static <T> ISeq<T> of(T... values)

Create a new ISeq from the given values.

Specified by:

of in interface Seq<T>

Type Parameters:

T - the element type

Parameters:

values - the array values.

Returns:

a new ISeq with the given values.

Throws:

NullPointerException - if the values array is null.

of

static <T> ISeq<T> of(Iterable<? extends T> values)

Create a new ISeq from the given values.

Specified by:

of in interface Seq<T>

Type Parameters:

T - the element type

Parameters:

values - the array values.

Returns:

a new ISeq with the given values.

Throws:

NullPointerException - if the values array is null.

of

static <T> ISeq<T> of(Supplier<? extends T> supplier,
                      int length)