public class IntUtils
extends Object
Provides extra functionality for int
primitives.
Constructor and Description |
---|
IntUtils() |
Modifier and Type | Method and Description |
---|---|
static Integer[] |
asObjectArray(int[] array)
Converts from an
int array to an Integer array. |
static int[] |
asPrimitiveArray(Integer[] array)
Converts from an
Integer array to an int array. |
static double |
average(int[] array)
Returns the average value of an array.
|
static double |
averageNonZeros(int[] array)
Returns the average value only among non-zero values
|
static int[] |
concatenate(int[]... arrays)
Concatenates a series of arrays.
|
static boolean |
contains(int[] array,
int value)
Checks if an input array contains a given value
|
static boolean |
containsAll(int[] array1,
int[] array2)
Checks if an array contains all numbers from another.
|
static boolean |
containsAny(int[] array1,
int[] array2)
Checks whether any element of an array is present in another.
|
static int[] |
copy(int[] array)
Returns a deep copy of the input
array . |
static int[][] |
copy(int[][] array)
Returns a deep copy of the input
array . |
static int[] |
divide(int[] array,
int value)
Divides all elements in an array by a scalar.
|
static int[] |
divide(int[] array1,
int[] array2)
Divides two arrays element-to-element.
|
static int[] |
divideNonSingular(int[] array1,
int[] array2)
Divides two arrays element-to-element, but when numerator and denominator = 0, returns 0 instead of a singularity (NaN)
|
static int[] |
find(int[] array,
int value,
Constants.SearchType searchType)
Returns the position(s) where a given value can be found into an array.
|
static int |
gcd(int[] array)
Computes the greatest absolute common divisor of an integer array.
|
static Comparator<int[]> |
getMatrixSorter(int columnId,
Constants.OrderingType orderingType)
Sorts a 2D
int array based on a given column. |
static int[] |
intersect(int[]... arrays)
Returns the intersection vector of a series of input arrays.
|
static String |
join(int[] array,
String separator)
Joins the elements in an input array using a given separator.
|
static int[] |
maxIndexes(int[] array,
Constants.SearchType searchType)
Returns the position(s) in which the maximum value is found.
|
static int[][] |
maxMinIndexes(int[] array,
Constants.SearchType searchType)
Returns the position(s) in which the maximum/minimum values are found.
|
static int[] |
maxMinValues(int[] array)
Returns the maximum/minimum values of an input array.
|
static int |
maxValue(int[] array)
Returns the maximum value in the input array.
|
static int |
maxValue(int[][] array)
Returns the maximum value in the input array.
|
static int[] |
minIndexes(int[] array,
Constants.SearchType searchType)
Returns the position(s) in which the minimum value is found.
|
static int |
minValue(int[] array)
Returns the minimum value in the input array.
|
static int[] |
mult(int[] array,
int value)
Multiplies all elements in an array by a scalar.
|
static int[] |
mult(int[] array1,
int[] array2)
Multiplies two arrays element-to-element.
|
static int[] |
ones(int N)
Returns an array filled with ones.
|
static void |
reverse(int[] array)
Reverses the order of the elements of the input array (it will be overriden).
|
static double |
scalarProduct(int[] array1,
int[] array2)
Scalar product of two vectors.
|
static int[] |
select(int[] array,
int[] indexes)
Returns a set of selected elements from an input array.
|
static int[] |
selectColumn(int[][] array,
int column)
Returns a column of a bidimensional input array.
|
static int[] |
selectRow(int[][] array,
int row)
Returns a row of a bidimensional input array.
|
static int[] |
setdiff(int[]... arrays)
Returns the elements contained in the first array, but not any of the others.
|
static void |
sort(int[] array,
Constants.OrderingType orderingType)
Sorts the input array (it will be overriden).
|
static int[] |
sortIndexes(int[] array,
Constants.OrderingType orderingType)
Sorts indexes of the
array into ascending/descending order in a stable way. |
static double |
std(int[] array)
Returns the standard deviation of an array.
|
static int[] |
substract(int[] array1,
int[] array2)
Returns the element-wise substraction of two arrays.
|
static double |
sum(int[] array)
Returns the sum of all elements in the array.
|
static int[] |
sum(int[] array1,
int[] array2)
Returns the element-wise sum of two arrays.
|
static int[] |
toArray(Collection<Integer> list)
Converts a collection (
List , Set ...) of Integer objects to a int array. |
static double[] |
toDoubleArray(int[] array)
Converts an
int array to a double array |
static List<Integer> |
toList(int[] array)
Converts from a
int array to a list. |
static int[] |
union(int[]... arrays)
Returns an array with all elements in input arrays (no repetitions).
|
static int[] |
unique(int[] array)
Returns the same values of the input
array but with no repetitions. |
static int[] |
zeros(int N)
Returns an array filled with zeros.
|
public static double average(int[] array)
array
- Input arraypublic static double averageNonZeros(int[] array)
array
- Input arraypublic static Integer[] asObjectArray(int[] array)
int
array to an Integer
array.array
- int
arrayInteger
arraypublic static int[] asPrimitiveArray(Integer[] array)
Integer
array to an int
array.array
- Integer
arrayint
arraypublic static boolean contains(int[] array, int value)
array
- Input arrayvalue
- Value to searchtrue
if value
is present in array
, and false otherwisepublic static boolean containsAll(int[] array1, int[] array2)
array1
- Container arrayarray2
- Array with elements to be checkedtrue
if value
is present in array
, and false otherwisepublic static boolean containsAny(int[] array1, int[] array2)
intersection(array1, array2).length == 0
.array1
- Container arrayarray2
- Array with elements to be checkedtrue
if any number in array1
is present in array2
, and false otherwisepublic static int[] copy(int[] array)
array
.array
- Input arrayarray
public static int[][] copy(int[][] array)
array
.array
- Input arrayarray
public static int[] find(int[] array, int value, Constants.SearchType searchType)
array
- Input arrayvalue
- Value to be searched forsearchType
- Indicates whether the first, the last, or all minimum positions are returnedpublic static int gcd(int[] array)
array
- Input arraygcd(0, 0)
is equal to zero and gcd([])
is equal to onepublic static int[] intersect(int[]... arrays)
arrays
- Vector of input arrayspublic static double[] toDoubleArray(int[] array)
int
array to a double
arrayarray
- Input arraydouble
arraypublic static String join(int[] array, String separator)
Arrays.toString()
.array
- Input arrayseparator
- SeparatorString
representation of the input array
public static int maxValue(int[] array)
array
- Input arraypublic static int maxValue(int[][] array)
array
- Input arraypublic static int[] maxIndexes(int[] array, Constants.SearchType searchType)
array
- Input arraysearchType
- Indicates whether the first, the last, or all maximum positions are returnedpublic static int[] maxMinValues(int[] array)
array
- Input arraypublic static int[][] maxMinIndexes(int[] array, Constants.SearchType searchType)
Returns the position(s) in which the maximum/minimum values are found.
out[0]
are the maximum positions, while out[1]
are the minimum positions
array
- Input arraysearchType
- Indicates whether the first, the last, or all maximum positions are returnedpublic static int minValue(int[] array)
array
- Input arraypublic static int[] minIndexes(int[] array, Constants.SearchType searchType)
array
- Input arraysearchType
- Indicates whether the first, the last, or all minimum positions are returnedpublic static int[] ones(int N)
N
- Number of elementsN
public static double std(int[] array)
array
- Input arraypublic static void reverse(int[] array)
array
- Input arraypublic static int[] selectColumn(int[][] array, int column)
array
- Input arraycolumn
- Columnpublic static int[] selectRow(int[][] array, int row)
array
- Input arrayrow
- Rowpublic static int[] select(int[] array, int[] indexes)
array
- Input arrayindexes
- Position of elements to be selected.indexes
public static int[] setdiff(int[]... arrays)
arrays
- Input arrayspublic static void sort(int[] array, Constants.OrderingType orderingType)
array
- Input arrayorderingType
- Ascending or descendingpublic static int[] sortIndexes(int[] array, Constants.OrderingType orderingType)
array
into ascending/descending order in a stable way. Stable means that index order doesn't change if values are the same.array
- Array to be sortedorderingType
- Ascending or descendingpublic static int[] toArray(Collection<Integer> list)
List
, Set
...) of Integer
objects to a int
array.list
- Input listint
arraypublic static List<Integer> toList(int[] array)
int
array to a list.array
- Input arrayInteger
objectspublic static int[] concatenate(int[]... arrays)
arrays
- List of arrayspublic static int[] union(int[]... arrays)
arrays
- Input arrayspublic static int[] unique(int[] array)
array
but with no repetitions. There is no order guarantee.array
- Input arrayarray
but with no repetitionspublic static int[] zeros(int N)
N
- Number of elementsN
public static double sum(int[] array)
array
- Input arraypublic static int[] sum(int[] array1, int[] array2)
array1
- Input array 1array2
- Input array 2public static int[] mult(int[] array, int value)
array
- Input arrayvalue
- Scalarpublic static int[] mult(int[] array1, int[] array2)
array1
- Input array 1array2
- Input array 2public static int[] substract(int[] array1, int[] array2)
array1
- Input array 1array2
- Input array 2public static int[] divide(int[] array, int value)
array
- Input arrayvalue
- Scalarpublic static int[] divide(int[] array1, int[] array2)
array1
- Numeratorarray2
- Denominatorpublic static int[] divideNonSingular(int[] array1, int[] array2)
array1
- Numeratorarray2
- Denominatorpublic static double scalarProduct(int[] array1, int[] array2)
array1
- Input array 1array2
- Input array 2public static Comparator<int[]> getMatrixSorter(int columnId, Constants.OrderingType orderingType)
int
array based on a given column.columnId
- Column identifierorderingType
- Ascending or descendingArrays.sort