com.landawn.abacus.util

Class CharMatrix

java.lang.Object

com.landawn.abacus.util.AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

com.landawn.abacus.util.CharMatrix

public final class CharMatrix
extends AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Since:

0.8

Author:

Haiyang Li

Field Summary

Fields inherited from class com.landawn.abacus.util.AbstractMatrix

cols, count, rows

Constructor Summary

Constructors

Constructor and Description
CharMatrix(char[][] a)

Method Summary

Modifier and Type	Method and Description
CharMatrix	add(CharMatrix b)
Stream<Pair.IntPair>	adjacent4Points(int i, int j) Returns the four adjacencies with order: up, right, down, left.
Stream<Pair.IntPair>	adjacent8Points(int i, int j) Returns the eight adjacencies with order: left-up, up, right-up, right, right-down, down, left-down, left.
char[][]	array()
Matrix<java.lang.Character>	boxed()
char[]	column(int columnIndex)
CharMatrix	copy()
CharMatrix	copy(int fromRowIndex, int toRowIndex)
CharMatrix	copy(int fromRowIndex, int toRowIndex, int fromColumnIndex, int toColumnIndex)
static CharMatrix	diagonal(char[] leftUp2RighDownDiagonal, char[] rightUp2LeftDownDiagonal)
static CharMatrix	diagonalLU2RD(char[] leftUp2RighDownDiagonal)
static CharMatrix	diagonalRU2LD(char[] rightUp2LeftDownDiagonal)
OptionalChar	downOf(int i, int j)
static CharMatrix	empty()
boolean	equals(java.lang.Object obj)
void	fill(char val)
void	fill(char[][] b)
void	fill(int fromRowIndex, int fromColumnIndex, char[][] b)
CharList	flatten()
CharMatrix	flipH()
CharMatrix	flipV()
void	forEach(CharConsumer action)
void	forEach(int fromRowIndex, int toRowIndex, int fromColumnIndex, int toColumnIndex, CharConsumer action)
char	get(int i, int j)
char	get(Pair.IntPair point)
char[]	getLU2RD()
char[]	getRU2LD()
int	hashCode()
CharMatrix	hstack(CharMatrix b)
OptionalChar	leftOf(int i, int j)
CharMatrix	map(CharUnaryOperator func)
<T> Matrix<T>	mapToObj(java.lang.Class<T> cls, CharFunction<? extends T> func)
CharMatrix	multiply(CharMatrix b)
static CharMatrix	of(char[]... a)
static CharMatrix	random(int len)
static CharMatrix	range(char startInclusive, char endExclusive)
static CharMatrix	range(char startInclusive, char endExclusive, int by)
static CharMatrix	rangeClosed(char startInclusive, char endInclusive)
static CharMatrix	rangeClosed(char startInclusive, char endInclusive, int by)
static CharMatrix	repeat(char val, int len)
CharMatrix	repelem(int rowRepeats, int colRepeats) Repeat elements rowRepeats times in row direction and colRepeats times in column direction.
void	replaceIf(CharPredicate predicate, char newValue)
void	replaceIf(IntBiPredicate predicate, char newValue) Replace elements by Predicate.test(i, j) based on points
CharMatrix	repmat(int rowRepeats, int colRepeats) Repeat this matrix rowRepeats times in row direction and colRepeats times in column direction.
CharMatrix	reshape(int newRows, int newCols)
void	reverseH()
void	reverseV()
OptionalChar	rightOf(int i, int j)
CharMatrix	rotate180() Rotate this matrix clockwise 180
CharMatrix	rotate270() Rotate this matrix clockwise 270
CharMatrix	rotate90() Rotate this matrix clockwise 90
char[]	row(int rowIndex)
void	set(int i, int j, char val)
void	set(Pair.IntPair point, char val)
void	setColumn(int columnIndex, char[] column)
void	setLU2RD(char[] diagonal)
void	setRow(int rowIndex, char[] row)
void	setRU2LD(char[] diagonal)
Stream<CharStream>	streamC()
Stream<CharStream>	streamC(int fromColumnIndex, int toColumnIndex)
CharStream	streamH()
CharStream	streamH(int rowIndex)
CharStream	streamH(int fromRowIndex, int toRowIndex)
CharStream	streamLU2RD()
Stream<CharStream>	streamR()
Stream<CharStream>	streamR(int fromRowIndex, int toRowIndex)
CharStream	streamRU2LD()
CharStream	streamV()
CharStream	streamV(int columnIndex)
CharStream	streamV(int fromColumnIndex, int toColumnIndex)
CharMatrix	subtract(CharMatrix b)
DoubleMatrix	toDoubleMatrix()
FloatMatrix	toFloatMatrix()
IntMatrix	toIntMatrix()
LongMatrix	toLongMatrix()
java.lang.String	toString()
CharMatrix	transpose()
void	updateAll(CharUnaryOperator func)
void	updateAll(IntBiFunction<java.lang.Character> func) Update all elements based on points
void	updateColumn(int columnIndex, CharUnaryOperator func)
void	updateLU2RD(CharUnaryOperator func)
void	updateRow(int rowIndex, CharUnaryOperator func)
void	updateRU2LD(CharUnaryOperator func)
OptionalChar	upOf(int i, int j)
CharMatrix	vstack(CharMatrix b)
CharMatrix	zipWith(CharMatrix matrixB, CharBiFunction<java.lang.Character> zipFunction)
CharMatrix	zipWith(CharMatrix matrixB, CharMatrix matrixC, CharTriFunction<java.lang.Character> zipFunction)

Methods inherited from class com.landawn.abacus.util.AbstractMatrix

isEmpty, isSameShape, pointsC, pointsC, pointsH, pointsH, pointsH, pointsLU2RD, pointsR, pointsR, pointsRU2LD, pointsV, pointsV, pointsV, println, reshape

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CharMatrix

public CharMatrix(char[][] a)

Method Detail

empty

public static CharMatrix empty()

of

@SafeVarargs
public static CharMatrix of(char[]... a)

random

public static CharMatrix random(int len)

repeat

public static CharMatrix repeat(char val,
                                int len)

range

public static CharMatrix range(char startInclusive,
                               char endExclusive)

range

public static CharMatrix range(char startInclusive,
                               char endExclusive,
                               int by)

rangeClosed

public static CharMatrix rangeClosed(char startInclusive,
                                     char endInclusive)

rangeClosed

public static CharMatrix rangeClosed(char startInclusive,
                                     char endInclusive,
                                     int by)

diagonalLU2RD

public static CharMatrix diagonalLU2RD(char[] leftUp2RighDownDiagonal)

diagonalRU2LD

public static CharMatrix diagonalRU2LD(char[] rightUp2LeftDownDiagonal)

diagonal

public static CharMatrix diagonal(char[] leftUp2RighDownDiagonal,
                                  char[] rightUp2LeftDownDiagonal)

array

public char[][] array()

get

public char get(int i,
                int j)

get

public char get(Pair.IntPair point)

set

public void set(int i,
                int j,
                char val)

set

public void set(Pair.IntPair point,
                char val)

upOf

public OptionalChar upOf(int i,
                         int j)

downOf

public OptionalChar downOf(int i,
                           int j)

leftOf

public OptionalChar leftOf(int i,
                           int j)

rightOf

public OptionalChar rightOf(int i,
                            int j)

adjacent4Points

public Stream<Pair.IntPair> adjacent4Points(int i,
                                            int j)

Returns the four adjacencies with order: up, right, down, left. null is set if the adjacency doesn't exist.

Parameters:

i -

j -

Returns:

adjacent8Points

public Stream<Pair.IntPair> adjacent8Points(int i,
                                            int j)

Returns the eight adjacencies with order: left-up, up, right-up, right, right-down, down, left-down, left. null is set if the adjacency doesn't exist.

Parameters:

i -

j -

Returns:

row

public char[] row(int rowIndex)

column

public char[] column(int columnIndex)

setRow

public void setRow(int rowIndex,
                   char[] row)

setColumn

public void setColumn(int columnIndex,
                      char[] column)

updateRow

public void updateRow(int rowIndex,
                      CharUnaryOperator func)

updateColumn

public void updateColumn(int columnIndex,
                         CharUnaryOperator func)

getLU2RD

public char[] getLU2RD()

setLU2RD

public void setLU2RD(char[] diagonal)

updateLU2RD

public void updateLU2RD(CharUnaryOperator func)

getRU2LD

public char[] getRU2LD()

setRU2LD

public void setRU2LD(char[] diagonal)

updateRU2LD

public void updateRU2LD(CharUnaryOperator func)

updateAll

public void updateAll(CharUnaryOperator func)

updateAll

public void updateAll(IntBiFunction<java.lang.Character> func)

Update all elements based on points

Parameters:

func -

replaceIf

public void replaceIf(CharPredicate predicate,
                      char newValue)

replaceIf

public void replaceIf(IntBiPredicate predicate,
                      char newValue)

Replace elements by Predicate.test(i, j) based on points

Parameters:

predicate -

newValue -

map

public CharMatrix map(CharUnaryOperator func)

mapToObj

public <T> Matrix<T> mapToObj(java.lang.Class<T> cls,
                              CharFunction<? extends T> func)

fill

public void fill(char val)

fill

public void fill(char[][] b)

fill

public void fill(int fromRowIndex,
                 int fromColumnIndex,
                 char[][] b)

copy

public CharMatrix copy()

Specified by:

copy in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a new Matrix

copy

public CharMatrix copy(int fromRowIndex,
                       int toRowIndex)

Specified by:

copy in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a new Matrix

copy

public CharMatrix copy(int fromRowIndex,
                       int toRowIndex,
                       int fromColumnIndex,
                       int toColumnIndex)

Specified by:

copy in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a new Matrix

reverseH

public void reverseH()

reverseV

public void reverseV()

flipH

public CharMatrix flipH()

flipV

public CharMatrix flipV()

rotate90

public CharMatrix rotate90()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 90

Specified by:

rotate90 in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a new Matrix

rotate180

public CharMatrix rotate180()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 180

Specified by:

rotate180 in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a new Matrix

rotate270

public CharMatrix rotate270()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 270

Specified by:

rotate270 in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a new Matrix

transpose

public CharMatrix transpose()

Specified by:

transpose in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

reshape

public CharMatrix reshape(int newRows,
                          int newCols)

Specified by:

reshape in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

repelem

public CharMatrix repelem(int rowRepeats,
                          int colRepeats)

Repeat elements rowRepeats times in row direction and colRepeats times in column direction.

Specified by:

repelem in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Parameters:

rowRepeats -

colRepeats -

Returns:

a new matrix

repmat

public CharMatrix repmat(int rowRepeats,
                         int colRepeats)

Repeat this matrix rowRepeats times in row direction and colRepeats times in column direction.

Specified by:

repmat in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Parameters:

rowRepeats -

colRepeats -

Returns:

a new matrix

flatten

public CharList flatten()

Specified by:

flatten in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

vstack

public CharMatrix vstack(CharMatrix b)

Parameters:

b -

Returns:

See Also:

IntMatrix.vstack(IntMatrix)

hstack

public CharMatrix hstack(CharMatrix b)

Parameters:

b -

Returns:

See Also:

IntMatrix.hstack(IntMatrix)

add

public CharMatrix add(CharMatrix b)

subtract

public CharMatrix subtract(CharMatrix b)

multiply

public CharMatrix multiply(CharMatrix b)

boxed

public Matrix<java.lang.Character> boxed()

toIntMatrix

public IntMatrix toIntMatrix()

toLongMatrix

public LongMatrix toLongMatrix()

toFloatMatrix

public FloatMatrix toFloatMatrix()

toDoubleMatrix

public DoubleMatrix toDoubleMatrix()

zipWith

public CharMatrix zipWith(CharMatrix matrixB,
                          CharBiFunction<java.lang.Character> zipFunction)

zipWith

public CharMatrix zipWith(CharMatrix matrixB,
                          CharMatrix matrixC,
                          CharTriFunction<java.lang.Character> zipFunction)

streamLU2RD

public CharStream streamLU2RD()

Specified by:

streamLU2RD in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a stream composed by elements on the diagonal line from left up to right down.

streamRU2LD

public CharStream streamRU2LD()

Specified by:

streamRU2LD in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a stream composed by elements on the diagonal line from right up to left down.

streamH

public CharStream streamH()

Specified by:

streamH in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a stream based on the order of row.

streamH

public CharStream streamH(int rowIndex)

Specified by:

streamH in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

streamH

public CharStream streamH(int fromRowIndex,
                          int toRowIndex)

Specified by:

streamH in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Parameters:

fromRowIndex -

toRowIndex -

Returns:

a stream based on the order of row.

streamV

@Beta
public CharStream streamV()

Specified by:

streamV in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a stream based on the order of column.

streamV

public CharStream streamV(int columnIndex)

Specified by:

streamV in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

streamV

@Beta
public CharStream streamV(int fromColumnIndex,
                                 int toColumnIndex)

Specified by:

streamV in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Parameters:

fromColumnIndex -

toColumnIndex -

Returns:

a stream based on the order of column.

streamR

public Stream<CharStream> streamR()

Specified by:

streamR in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a row stream based on the order of row.

streamR

public Stream<CharStream> streamR(int fromRowIndex,
                                  int toRowIndex)

Specified by:

streamR in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Parameters:

fromRowIndex -

toRowIndex -

Returns:

a row stream based on the order of row.

streamC

@Beta
public Stream<CharStream> streamC()

Specified by:

streamC in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Returns:

a column stream based on the order of column.

streamC

@Beta
public Stream<CharStream> streamC(int fromColumnIndex,
                                         int toColumnIndex)

Specified by:

streamC in class AbstractMatrix<char[],CharList,CharStream,Stream<CharStream>,CharMatrix>

Parameters:

fromColumnIndex -

toColumnIndex -

Returns:

a column stream based on the order of column.

forEach

public void forEach(CharConsumer action)

forEach

public void forEach(int fromRowIndex,
                    int toRowIndex,
                    int fromColumnIndex,
                    int toColumnIndex,
                    CharConsumer action)

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object