Klasse Matrix<E>

java.lang.Object

ch.nolix.core.container.base.AbstractContainer<E>

ch.nolix.core.container.arraylist.AbstractExtendedContainer<E>

ch.nolix.core.container.matrix.Matrix<E>

Typparameter:

E - is the type of the elements of a Matrix.

Alle implementierten Schnittstellen:

Filterable<E>, Groupable<E>, IContainer<E>, IFilteringContainerViewProvider<E>, IIntervallContainerViewProvider<E>, IMappingContainerViewProvider<E>, Mappable<E>, AggregationRequestable<E>, ArrayMappable<E>, CountRequestable<E>, IndexRequestable<E>, IterableWithCopyableIterator<E>, SingleSearchable<E>, StoringRequestable<E>, StringMappable, IMatrix<E>, Clearable, EmptinessRequestable, MaterializationRequestable, Iterable<E>

public final class Matrix<E>
extends AbstractExtendedContainer<E>
implements IMatrix<E>

A Matrix is a AbstractContainer that stores its elements in rows and columns. A Matrix is clearable.

Autor:

Silvan Wyss

Methodenübersicht

Modifikator und Typ	Methode	Beschreibung
Matrix<E>	addColumn(E element, E... elements)	Adds a new column to the current Matrix with the given elements.
Matrix<E>	addColumn(Iterable<E> elements)	Adds a new column to the current Matrix with the given elements.
Matrix<E>	addRow(E... elements)	Adds a new row to the current Matrix with the given elements.
Matrix<E>	addRow(Iterable<E> elements)	Adds a new row to the current Matrix with the given elements.
void	clear()	Removes all elements of the current Matrix.
static <T> Matrix<T>	createEmpty()
static <T> Matrix<T>	fromMatrix(IMatrix<T> matrix)
MatrixColumn<E>	getColumn(int columnIndex)
int	getColumnCount()	The time complexity of this implementation is O(1).
int	getColumnIndexOf(int index)
IContainer<MatrixColumn<E>>	getColumns()
Matrix<E>	getCopy()	The time complexity of this implementation is O(m * n) if: -This matrix contains m rows.
int	getCount()	The time complexity of this implementation is O(1).
int	getIndexOf(int rowIndex, int columnIndex)
MatrixRow<E>	getRow(int rowIndex)
int	getRowCount()	The time complexity of this implementation is O(1).
int	getRowIndexOf(int index)
IContainer<MatrixRow<E>>	getRows()
E	getStoredAtOneBasedIndex(int oneBasedIndex)
E	getStoredAtOneBasedRowIndexAndColumnIndex(int oneBasedRowIndex, int oneBasedColumnIndex)	The time complexity of this implementation is O(1).
boolean	isMaterialized()
CopyableIterator<E>	iterator()	The time complexity of this implementation is O(1).
void	setAt(int index, E element)	Sets the given element to the current Matrix at the given index.
void	setAtOneBasedRowIndexAndColumnIndex(int oneBasedRowIndex, int oneBasedColumnIndex, E element)	Sets the given element to the current Matrix to the row with the given row index and the column with the given column index.
Matrix<E>	toLeftRotatedMatrix()	The time complexity of this implementation is O(n) if the current Matrix contains n elements.
<O> Matrix<O>	toMatrix(Function<E,O> transformer)	The time complexity of this implementation is O(n) if: -This matrix contains n elements.
Matrix<E>	toRightRotatedMatrix()	The time complexity of this implementation is O(n) if the current Matrix contains n elements.
String	toString()	The time complexity of this implementation is O(n) if: -The current Matrix contains n elements.

Von Klasse geerbte Methoden AbstractExtendedContainer

createEmptyMutableList, getViewFromOneBasedStartIndexToOneBasedEndIndex, getViewOf, getViewOfStoredSelected, toOrderedList

Von Klasse geerbte Methoden AbstractContainer

contains, containsAll, containsAll, containsAll, containsAny, containsAny, containsAnyOf, containsAnyOf, containsAsManyAs, containsEqualing, containsExactlyEqualingInSameOrder, containsExactlyInSameOrder, containsLessThan, containsMoreThan, containsNone, containsNone, containsNoneOf, containsOnce, containsOne, containsOne, containsOneEqualing, containsOnly, getAverage, getAverageOrZero, getCount, getCountOf, getMax, getMaxOrZero, getMedian, getMedianOrZero, getMin, getMinOrZero, getOneBasedIndexOfFirst, getOneBasedIndexOfFirstEqualElement, getOneBasedIndexOfFirstOccurrenceOf, getOptionalStoredFirst, getOptionalStoredFirst, getStandardDeviation, getStoredByMax, getStoredByMin, getStoredFirst, getStoredFirst, getStoredFirstOfType, getStoredInGroups, getStoredLast, getStoredOfType, getStoredOne, getStoredOne, getStoredOthers, getStoredSelected, getSum, getSumOfInts, getVariance, getViewFromOneBasedStartIndex, getViewToOneBasedEndIndex, getViewWithoutFirst, getViewWithoutFirst, getViewWithoutLast, getViewWithoutLast, isEmpty, to, toArray, toByteArray, toCharArray, toConcatenatedString, toDoubleArray, toIntArray, toLongArray, toMultiples, toNumbers, toReversedList, toStringArray, toStrings, toStringWithSeparator, toStringWithSeparator, toWithOneBasedIndex

Von Klasse geerbte Methoden Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Von Schnittstelle geerbte Methoden AggregationRequestable

getAverage, getAverageOrZero, getMax, getMaxOrZero, getMedian, getMedianOrZero, getMin, getMinOrZero, getStandardDeviation, getSum, getSumOfInts, getVariance

Von Schnittstelle geerbte Methoden ArrayMappable

toArray, toByteArray, toCharArray, toDoubleArray, toIntArray, toLongArray, toStringArray

Von Schnittstelle geerbte Methoden CountRequestable

getCount, getCountOf

Von Schnittstelle geerbte Methoden EmptinessRequestable

containsAny, isEmpty

Von Schnittstelle geerbte Methoden Filterable

getStoredOfType, getStoredOthers, getStoredSelected

Von Schnittstelle geerbte Methoden Groupable

getStoredInGroups

Von Schnittstelle geerbte Methoden IContainer

toOrderedList, toReversedList

Von Schnittstelle geerbte Methoden IFilteringContainerViewProvider

getViewOfStoredSelected

Von Schnittstelle geerbte Methoden IIntervallContainerViewProvider

getViewFromOneBasedStartIndex, getViewFromOneBasedStartIndexToOneBasedEndIndex, getViewToOneBasedEndIndex, getViewWithoutFirst, getViewWithoutFirst, getViewWithoutLast, getViewWithoutLast

Von Schnittstelle geerbte Methoden IMappingContainerViewProvider

getViewOf

Von Schnittstelle geerbte Methoden IndexRequestable

getOneBasedIndexOfFirst, getOneBasedIndexOfFirstEqualElement, getOneBasedIndexOfFirstOccurrenceOf

Von Schnittstelle geerbte Methoden Iterable

forEach, spliterator

Von Schnittstelle geerbte Methoden Mappable

to, toMultiples, toNumbers, toStrings, toWithOneBasedIndex

Von Schnittstelle geerbte Methoden MaterializationRequestable

isView

Von Schnittstelle geerbte Methoden SingleSearchable

getOptionalStoredFirst, getOptionalStoredFirst, getStoredByMax, getStoredByMin, getStoredFirst, getStoredFirst, getStoredFirstOfType, getStoredLast, getStoredOne, getStoredOne

Von Schnittstelle geerbte Methoden StoringRequestable

contains, containsAll, containsAll, containsAll, containsAny, containsAny, containsAnyOf, containsAnyOf, containsAsManyAs, containsEqualing, containsExactlyEqualingInSameOrder, containsExactlyInSameOrder, containsLessThan, containsMoreThan, containsNone, containsNone, containsNoneOf, containsOnce, containsOne, containsOne, containsOneEqualing, containsOnly

Von Schnittstelle geerbte Methoden StringMappable

toConcatenatedString, toStringWithSeparator, toStringWithSeparator

Methodendetails

createEmpty

public static <T> Matrix<T> createEmpty()

Typparameter:

T - is the type of the elements of the created Matrix.

Gibt zurück:

a new empty Matrix.

fromMatrix

public static <T> Matrix<T> fromMatrix(IMatrix<T> matrix)

Typparameter:

T - is the type of the elements of the given matrix.

Parameter:

matrix -

Gibt zurück:

a new Matrix with the size and elements of the given matrix.

addColumn

public Matrix<E> addColumn(E element,
 E... elements)

Adds a new column to the current Matrix with the given elements. The complexity of this implementation is O(m + n) if: -The current Matrix contains m elements. -n elements are given.

Parameter:

element -

elements -

Gibt zurück:

the current Matrix.

Löst aus:

ArgumentIsNullException - if the given elements is null.

ArgumentIsNullException - if one of the given elements is null.

UnequalArgumentException - if the current Matrix is not empty and if not as many elements are given as the number of rows of the current Matrix.

addColumn

public Matrix<E> addColumn(Iterable<E> elements)

Adds a new column to the current Matrix with the given elements. The complexity of this implementation is O(m + n) if: -The current Matrix contains m elements. -n elements are given.

Parameter:

elements -

Gibt zurück:

the current Matrix.

Löst aus:

ArgumentIsNullException - if the given elements is null.

ArgumentIsNullException - if one of the given elements is null.

UnequalArgumentException - if the current Matrix is not empty and if not as many elements are given as the number of rows of the current Matrix.

addRow

public Matrix<E> addRow(E... elements)

Adds a new row to the current Matrix with the given elements. The complexity of this implementation is O(m + n) if: -The current Matrix contains m rows. -n elements are given.

Parameter:

elements -

Gibt zurück:

the current Matrix.

Löst aus:

ArgumentIsNullException - if the given elements is null.

ArgumentIsNullException - if one of the given elements is null.

UnequalArgumentException - the current Matrix is not empty and if not as many elements are given as the number of columns of the current Matrix.

addRow

public Matrix<E> addRow(Iterable<E> elements)

Adds a new row to the current Matrix with the given elements. The complexity of this implementation is O(m + n) if: -The current Matrix contains m rows. -n elements are given.

Parameter:

elements -

Gibt zurück:

the current Matrix.

Löst aus:

ArgumentIsNullException - if the given elements is null.

ArgumentIsNullException - if one of the given elements is null.

UnequalArgumentException - the current Matrix is not empty and if not as many elements are given as the number of columns of the current Matrix.

clear

public void clear()

Removes all elements of the current Matrix. The complexity of this implementation is O(1).

Angegeben von:

clear in Schnittstelle Clearable

getColumn

public MatrixColumn<E> getColumn(int columnIndex)

Parameter:

columnIndex -

Gibt zurück:

the column of the current Matrix with the given column index.

Löst aus:

NonPositiveArgumentException - if the given column index is not positive.

BiggerArgumentException - if the given column index is bigger than the number of columns of the current Matrix.

getColumnCount

public int getColumnCount()

The time complexity of this implementation is O(1).

Angegeben von:

getColumnCount in Schnittstelle IMatrix<E>

Gibt zurück:

the number of columns of the current Matrix.

getColumnIndexOf

public int getColumnIndexOf(int index)

Parameter:

index -

Gibt zurück:

the index of the column of the element of the current Matrix at the given index.

Löst aus:

NonPositiveArgumentException - if the given index is not positive.

BiggerArgumentException - if the given index is bigger than the number of elements of the current Matrix.

getColumns

public IContainer<MatrixColumn<E>> getColumns()

Angegeben von:

getColumns in Schnittstelle IMatrix<E>

Gibt zurück:

the columns of the current Matrix.

getCopy

public Matrix<E> getCopy()

The time complexity of this implementation is O(m * n) if: -This matrix contains m rows. -This matrix contains n columns.

Gibt zurück:

a new Matrix with the elements of the current Matrix.

getCount

public int getCount()

The time complexity of this implementation is O(1).

Angegeben von:

getCount in Schnittstelle CountRequestable<E>

Gibt zurück:

the number of elements of the current Matrix.

getIndexOf

public int getIndexOf(int rowIndex,
 int columnIndex)

Parameter:

rowIndex -

columnIndex -

Gibt zurück:

the index of the element of the current Matrix at the given row index and column index.

Löst aus:

NonPositiveArgumentException - if the given row index is not positive.

BiggerArgumentException - if the given row index is bigger than the number of rows of the current Matrix.

NonPositiveArgumentException - if the given column index is not positive.

BiggerArgumentException - if the given column index is bigger than the number of columns of the current Matrix.

getStoredAtOneBasedIndex

public E getStoredAtOneBasedIndex(int oneBasedIndex)

Angegeben von:

getStoredAtOneBasedIndex in Schnittstelle SingleSearchable<E>

Parameter:

oneBasedIndex -

Gibt zurück:

the element of the current Matrix at the given index .

Löst aus:

NonPositiveArgumentException - if the given index is not positive.

BiggerArgumentException - if the given index is bigger than the number of elements of the current Matrix.

getStoredAtOneBasedRowIndexAndColumnIndex

public E getStoredAtOneBasedRowIndexAndColumnIndex(int oneBasedRowIndex,
 int oneBasedColumnIndex)

The time complexity of this implementation is O(1).

Angegeben von:

getStoredAtOneBasedRowIndexAndColumnIndex in Schnittstelle IMatrix<E>

Parameter:

oneBasedRowIndex -

oneBasedColumnIndex -

Gibt zurück:

the element of the current Matrix at the given row index and column index.

Löst aus:

NonPositiveArgumentException - if the given row index is not positive.

BiggerArgumentException - if the given row index is bigger than the number of rows of the current Matrix.

NonPositiveArgumentException - if the given column index is not positive.

BiggerArgumentException - if the given column index is bigger than the number of columns of the current Matrix.

getRow

public MatrixRow<E> getRow(int rowIndex)

Parameter:

rowIndex -

Gibt zurück:

the row of the current Matrix at the given row index.

Löst aus:

NonPositiveArgumentException - if the given row index is not positive.

BiggerArgumentException - if the given row index is bigger than the number of rows of the current Matrix.

getRowIndexOf

public int getRowIndexOf(int index)

Parameter:

index -

Gibt zurück:

the index of the row of the element of the current Matrix at the given index.

Löst aus:

NonPositiveArgumentException - if the given index is not positive.

BiggerArgumentException - if the given index is bigger than the number of elements of the current Matrix.

getRows

public IContainer<MatrixRow<E>> getRows()

Angegeben von:

getRows in Schnittstelle IMatrix<E>

Gibt zurück:

the rows of the current Matrix.

getRowCount

public int getRowCount()

The time complexity of this implementation is O(1).

Angegeben von:

getRowCount in Schnittstelle IMatrix<E>

Gibt zurück:

the number of rows of the current Matrix.

isMaterialized

public boolean isMaterialized()

Angegeben von:

isMaterialized in Schnittstelle MaterializationRequestable

Gibt zurück:

true if the current MaterializationRequestable is materialized, false otherwise.

iterator

public CopyableIterator<E> iterator()

The time complexity of this implementation is O(1).

Angegeben von:

iterator in Schnittstelle Iterable<E>

Angegeben von:

iterator in Schnittstelle IterableWithCopyableIterator<E>

Gibt zurück:

a new iterator for the current Matrix.

setAt

public void setAt(int index,
 E element)

Sets the given element to the current Matrix at the given index. The complexity of this implementation is O(1).

Parameter:

index -

element -

Löst aus:

NonPositiveArgumentException - if the given index is not positive.

BiggerArgumentException - if the given index is bigger than the number of elements of the current Matrix.

ArgumentIsNullException - if the given element is null.

setAtOneBasedRowIndexAndColumnIndex

public void setAtOneBasedRowIndexAndColumnIndex(int oneBasedRowIndex,
 int oneBasedColumnIndex,
 E element)

Sets the given element to the current Matrix to the row with the given row index and the column with the given column index. The time complexity of this implementation is O(1).

Angegeben von:

setAtOneBasedRowIndexAndColumnIndex in Schnittstelle IMatrix<E>

Parameter:

oneBasedRowIndex -

oneBasedColumnIndex -

element -

Löst aus:

NonPositiveArgumentException - if the given row index is not positive.

BiggerArgumentException - if the given row index is bigger than the number of rows of the current Matrix.

NonPositiveArgumentException - if the given column index is not positive.

BiggerArgumentException - if the given column index is bigger than the number of columns of the current Matrix.

ArgumentIsNullException - if the given element is null.

toMatrix

public <O> Matrix<O> toMatrix(Function<E,O> transformer)

The time complexity of this implementation is O(n) if: -This matrix contains n elements. -The given transformer has a complexity of O(1).

Typparameter:

O - is the type of the elements the given transformer returns.

Parameter:

transformer -

Gibt zurück:

a new matrix with the elements the given transformer transforms of the elements of the current Matrix.

toLeftRotatedMatrix

public Matrix<E> toLeftRotatedMatrix()

The time complexity of this implementation is O(n) if the current Matrix contains n elements.

Gibt zurück:

a new left rotated Matrix of the current Matrix.

toRightRotatedMatrix

public Matrix<E> toRightRotatedMatrix()

The time complexity of this implementation is O(n) if the current Matrix contains n elements.

Gibt zurück:

a new right rotated Matrix of the current Matrix.

toString

public String toString()

The time complexity of this implementation is O(n) if: -The current Matrix contains n elements. -The toString method of the elements of the current Matrix has a complexity of O(1).

Setzt außer Kraft:

toString in Klasse Object

Gibt zurück:

a String representation of the current Matrix.