AssertJ Core 3.26.0 · org.assertj.core.api.Long2DArrayAssert

Modifier and Type	Field and Description
private final Failures	failures
protected Long2DArrays	long2dArrays

Access	Constructor and Description
public	Long2DArrayAssert(long[][] actual)

Method Summary

Modifier and Type	Method and Description
public Long2DArrayAssert	Returns: myself assertion object. contains(long[] the value to look for. value, Index the index where the value should be stored in the actual array. index) Verifies that the actual array contains the given long[] at the given index.
public Long2DArrayAssert	Returns: myself assertion object. doesNotContain(long[] the value to look for. value, Index the index where the value should be stored in the actual array. index) Verifies that the actual array does not contain the given long[] at the given index.
public Long2DArrayAssert	Returns: `this` assertion object. hasDimensions(int the expected number of values in first dimension of the actual array. expectedFirstDimension, int the expected number of values in second dimension of the actual array. expectedSecondDimension) Implements org.assertj.core.api.Array2DAssert.hasDimensions. Verifies that the actual 2D array has the given dimensions.
public Long2DArrayAssert	Returns: `this` assertion object. hasNumberOfRows(int the expected number of rows of the two-dimensional array. expected) Implements org.assertj.core.api.Array2DAssert.hasNumberOfRows. Verifies that the actual two-dimensional array has the given number of rows.
public Long2DArrayAssert	Returns: `this` assertion object. hasSameDimensionsAs(Object the array to compare dimensions with actual `long[][]`. array) Implements org.assertj.core.api.Array2DAssert.hasSameDimensionsAs. Verifies that the actual `long[][]` has the same dimensions as the given array.
public Long2DArrayAssert	Returns: `this` assertion object. isDeepEqualTo(long[][] the given value to compare the actual value to. expected) Implements abstract org.assertj.core.api.Abstract2DArrayAssert.isDeepEqualTo. Verifies that the actual 2D array is deeply equal to the given one.
public void	isEmpty() Implements org.assertj.core.api.Array2DAssert.isEmpty. Verifies that the actual array is empty, empty means the array has no elements, said otherwise it can have any number of rows but all rows must be empty.
public Long2DArrayAssert	Returns: `this` assertion object. isEqualTo(Object the given value to compare the actual `long[][]` to. expected) Overrides org.assertj.core.api.AbstractAssert.isEqualTo. Implements org.assertj.core.api.Assert.isEqualTo. Verifies that the actual `long[][]` is equal to the given one.
public Long2DArrayAssert	Returns: `this` assertion object. isNotEmpty() Implements org.assertj.core.api.Array2DAssert.isNotEmpty. Verifies that the actual array is not empty, not empty means the array has at least one element.
public void	isNullOrEmpty() Implements org.assertj.core.api.Array2DAssert.isNullOrEmpty. Verifies that the actual array is `null` or empty, empty means the array has no elements, said otherwise it can have any number of rows but all rows must be empty.

failures	back to summary
private final Failures failures

long2dArrays	back to summary
protected Long2DArrays long2dArrays Annotations @VisibleForTesting

Long2DArrayAssert	back to summary
public Long2DArrayAssert(long[][] actual)

Method Detail

contains	back to summary
public Long2DArrayAssert contains(long[] value, Index index) Verifies that the actual array contains the given long[] at the given index. Example: `// assertion will pass assertThat(new long[][] {{1L, 2L}, {3L, 4L}, {5L, 6L}}).contains(new long[] {3L, 4L}, atIndex(1)); // assertions will fail assertThat(new long[][] {{1L, 2L}, {3L, 4L}, {5L, 6L}}).contains(new long[] {3L, 4L}, atIndex(0)); assertThat(new long[][] {{1L, 2L}, {3L, 4L}, {5L, 6L}}).contains(new long[] {7L, 8L}, atIndex(2));` Parameters value:long[] the value to look for. index:Index the index where the value should be stored in the actual array. Returns:Long2DArrayAssert myself assertion object. Exceptions AssertionError: if the actual array is `null` or empty. if the actual array does not contain the given value at the given index. NullPointerException: if the given `Index` is `null`. IndexOutOfBoundsException: if the value of the given `Index` is equal to or greater than the size of the actual array.

doesNotContain	back to summary
public Long2DArrayAssert doesNotContain(long[] value, Index index) Verifies that the actual array does not contain the given long[] at the given index. Example: `// assertions will pass assertThat(new long[][] {{1L, 2L}, {3L, 4L}, {5L, 6L}}).doesNotContain(new long[] {3L, 4L}, atIndex(0)); assertThat(new long[][] {{1L, 2L}, {3L, 4L}, {5L, 6L}}).doesNotContain(new long[] {7L, 8L}, atIndex(2)); // assertion will fail assertThat(new long[][] {{1L, 2L}, {3L, 4L}, {5L, 6L}}).doesNotContain(new long[] {3L, 4L}, atIndex(1));` Parameters value:long[] the value to look for. index:Index the index where the value should be stored in the actual array. Returns:Long2DArrayAssert myself assertion object. Exceptions AssertionError: if the actual array is `null`. if the actual array contains the given value at the given index. NullPointerException: if the given `Index` is `null`.

hasDimensions back to summary

hasDimensions	back to summary
public Long2DArrayAssert hasDimensions(int expectedFirstDimension, int expectedSecondDimension) Implements org.assertj.core.api.Array2DAssert.hasDimensions. Verifies that the actual 2D array has the given dimensions. Example: `// assertion will pass assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasDimensions(2, 3); // assertions will fail assertThat(new long[][] { }).hasSize(1, 1); assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasDimensions(3, 2); assertThat(new long[][] {{1, 2, 3}, {4, 5, 6, 7}}).hasDimensions(2, 3);` Parameters expectedFirstDimension:int the expected number of values in first dimension of the actual array. expectedSecondDimension:int the expected number of values in second dimension of the actual array. Returns:Long2DArrayAssert `this` assertion object. Annotations @Override Exceptions AssertionError: if the actual array's dimensions are not equal to the given ones.

public Long2DArrayAssert hasDimensions(int expectedFirstDimension, int expectedSecondDimension)

Implements org.assertj.core.api.Array2DAssert.hasDimensions.

Verifies that the actual 2D array has the given dimensions.

Example:

 // assertion will pass
assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasDimensions(2, 3);

// assertions will fail
assertThat(new long[][] { }).hasSize(1, 1);
assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasDimensions(3, 2);
assertThat(new long[][] {{1, 2, 3}, {4, 5, 6, 7}}).hasDimensions(2, 3);

Parameters

expectedFirstDimension:int: the expected number of values in first dimension of the actual array.
expectedSecondDimension:int: the expected number of values in second dimension of the actual array.

Returns:Long2DArrayAssert

this assertion object.

Annotations

@Override

Exceptions

AssertionError:: if the actual array's dimensions are not equal to the given ones.

hasNumberOfRows back to summary

hasNumberOfRows	back to summary
public Long2DArrayAssert hasNumberOfRows(int expected) Implements org.assertj.core.api.Array2DAssert.hasNumberOfRows. Verifies that the actual two-dimensional array has the given number of rows. Example: `// assertion will pass assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasNumberOfRows(2); assertThat(new long[][] {{1}, {1, 2}, {1, 2, 3}}).hasNumberOfRows(3); // assertions will fail assertThat(new long[][] { }).hasNumberOfRows(1); assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasNumberOfRows(3); assertThat(new long[][] {{1, 2, 3}, {4, 5, 6, 7}}).hasNumberOfRows(1);` Parameters expected:int the expected number of rows of the two-dimensional array. Returns:Long2DArrayAssert `this` assertion object. Annotations @Override Exceptions AssertionError: if the actual number of rows are not equal to the given one.

public Long2DArrayAssert hasNumberOfRows(int expected)

Implements org.assertj.core.api.Array2DAssert.hasNumberOfRows.

Verifies that the actual two-dimensional array has the given number of rows.

Example:

 // assertion will pass
assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasNumberOfRows(2);
assertThat(new long[][] {{1}, {1, 2}, {1, 2, 3}}).hasNumberOfRows(3);

// assertions will fail
assertThat(new long[][] { }).hasNumberOfRows(1);
assertThat(new long[][] {{1, 2, 3}, {4, 5, 6}}).hasNumberOfRows(3);
assertThat(new long[][] {{1, 2, 3}, {4, 5, 6, 7}}).hasNumberOfRows(1);

Parameters

expected:int: the expected number of rows of the two-dimensional array.

Returns:Long2DArrayAssert

this assertion object.

Annotations

@Override

Exceptions

AssertionError:: if the actual number of rows are not equal to the given one.

hasSameDimensionsAs back to summary

hasSameDimensionsAs	back to summary
public Long2DArrayAssert hasSameDimensionsAs(Object array) Implements org.assertj.core.api.Array2DAssert.hasSameDimensionsAs. Verifies that the actual `long[][]` has the same dimensions as the given array. Parameter is declared as Object to accept both Object and primitive arrays. Example: `long[][] longArray = {{1, 2, 3}, {4, 5, 6}}; char[][] charArray = {{'a', 'b', 'c'}, {'d', 'e', 'f'}}; // assertion will pass assertThat(longArray).hasSameDimensionsAs(charArray); // assertions will fail assertThat(longArray).hasSameDimensionsAs(new char[][] {{'a', 'b'}, {'c', 'd'}, {'e', 'f'}}); assertThat(longArray).hasSameDimensionsAs(new char[][] {{'a', 'b'}, {'c', 'd', 'e'}}); assertThat(longArray).hasSameDimensionsAs(new char[][] {{'a', 'b', 'c'}, {'d', 'e'}});` Parameters array:Object the array to compare dimensions with actual `long[][]`. Returns:Long2DArrayAssert `this` assertion object. Annotations @Override Exceptions AssertionError: if the actual `long[][]` is `null`. if the array parameter is `null` or is not a true array. if actual `long[][]` and given array don't have the same dimensions.

public Long2DArrayAssert hasSameDimensionsAs(Object array)

Implements org.assertj.core.api.Array2DAssert.hasSameDimensionsAs.

Verifies that the actual long[][] has the same dimensions as the given array.

Parameter is declared as Object to accept both Object and primitive arrays.

Example:

 long[][] longArray = {{1, 2, 3}, {4, 5, 6}};
char[][] charArray = {{'a', 'b', 'c'}, {'d', 'e', 'f'}};

// assertion will pass
assertThat(longArray).hasSameDimensionsAs(charArray);

// assertions will fail
assertThat(longArray).hasSameDimensionsAs(new char[][] {{'a', 'b'}, {'c', 'd'}, {'e', 'f'}});
assertThat(longArray).hasSameDimensionsAs(new char[][] {{'a', 'b'}, {'c', 'd', 'e'}});
assertThat(longArray).hasSameDimensionsAs(new char[][] {{'a', 'b', 'c'}, {'d', 'e'}});

Parameters

array:Object: the array to compare dimensions with actual long[][].

Returns:Long2DArrayAssert

this assertion object.

Annotations

@Override

Exceptions

AssertionError:

if the actual long[][] is null.
if the array parameter is null or is not a true array.
if actual long[][] and given array don't have the same dimensions.

isDeepEqualTo back to summary

isDeepEqualTo	back to summary
public Long2DArrayAssert isDeepEqualTo(long[][] expected) Implements abstract org.assertj.core.api.Abstract2DArrayAssert.isDeepEqualTo. Verifies that the actual 2D array is deeply equal to the given one. Two arrays are considered deeply equal if both are `null` or if they refer to arrays that contain the same number of elements and all corresponding pairs of elements in the two arrays are deeply equal. Example: `// assertion will pass assertThat(new long[][] {{1, 2}, {3, 4}}).isDeepEqualTo(new long[][] {{1, 2}, {3, 4}}); // assertions will fail assertThat(new long[][] {{1, 2}, {3, 4}}).isDeepEqualTo(new long[][] {{1, 2}, {9, 10}}); assertThat(new long[][] {{1, 2}, {3, 4}}).isDeepEqualTo(new long[][] {{1, 2, 3}, {4}});` Parameters expected:long[][] the given value to compare the actual value to. Returns:Long2DArrayAssert `this` assertion object. Annotations @Override Exceptions AssertionError: if the actual value is not deeply equal to the given one.

public Long2DArrayAssert isDeepEqualTo(long[][] expected)

Implements abstract org.assertj.core.api.Abstract2DArrayAssert.isDeepEqualTo.

Verifies that the actual 2D array is deeply equal to the given one.

Two arrays are considered deeply equal if both are null or if they refer to arrays that contain the same number of elements and all corresponding pairs of elements in the two arrays are deeply equal.

Example:

 // assertion will pass
assertThat(new long[][] {{1, 2}, {3, 4}}).isDeepEqualTo(new long[][] {{1, 2}, {3, 4}});

// assertions will fail
assertThat(new long[][] {{1, 2}, {3, 4}}).isDeepEqualTo(new long[][] {{1, 2}, {9, 10}});
assertThat(new long[][] {{1, 2}, {3, 4}}).isDeepEqualTo(new long[][] {{1, 2, 3}, {4}});

Parameters

expected:long[][]: the given value to compare the actual value to.

Returns:Long2DArrayAssert

this assertion object.

Annotations

@Override

Exceptions

AssertionError:: if the actual value is not deeply equal to the given one.

isEmpty back to summary

isEmpty	back to summary
public void isEmpty() Implements org.assertj.core.api.Array2DAssert.isEmpty. Verifies that the actual array is empty, empty means the array has no elements, said otherwise it can have any number of rows but all rows must be empty. Example: `// assertion will pass assertThat(new long[][] {{}}).isEmpty(); assertThat(new long[][] {{ }}).isNullOrEmpty(); // this is considered empty as there are no elements in the 2d array which is comprised of 3 empty rows. assertThat(new long[][] {{ }, { }, { }}).isNullOrEmpty(); // assertions will fail assertThat(new long[][] {{ 1 }, { 2 }}).isEmpty(); long[][] array = null; assertThat(array).isEmpty();` Annotations @Override Exceptions AssertionError: if the actual array is not empty.

public void isEmpty()

Implements org.assertj.core.api.Array2DAssert.isEmpty.

Verifies that the actual array is empty, empty means the array has no elements, said otherwise it can have any number of rows but all rows must be empty.

Example:

 // assertion will pass
assertThat(new long[][] {{}}).isEmpty();
assertThat(new long[][] {{ }}).isNullOrEmpty();
// this is considered empty as there are no elements in the 2d array which is comprised of 3 empty rows.
assertThat(new long[][] {{ }, { }, { }}).isNullOrEmpty();

// assertions will fail
assertThat(new long[][] {{ 1 }, { 2 }}).isEmpty();
long[][] array = null;
assertThat(array).isEmpty();

Annotations

@Override

Exceptions

AssertionError:: if the actual array is not empty.

isEqualTo back to summary

isEqualTo	back to summary
public Long2DArrayAssert isEqualTo(Object expected) Overrides org.assertj.core.api.AbstractAssert.isEqualTo. Implements org.assertj.core.api.Assert.isEqualTo. Verifies that the actual `long[][]` is equal to the given one. Warning This method will use `equals` to compare (it will compare arrays references only). Unless you specify a comparator with `usingComparator(Comparator)`, it is advised to use `isDeepEqualTo(long[][])` instead. Example: `long[][] array = {{1, 2}, {3, 4}}; // assertion will pass assertThat(array).isEqualTo(array); // assertion will fail as isEqualTo calls equals which compares arrays references only. assertThat(array).isEqualTo(new long[][] {{1, 2}, {3, 4}});` Parameters expected:Object the given value to compare the actual `long[][]` to. Returns:Long2DArrayAssert `this` assertion object. Annotations @Override Exceptions AssertionError: if the actual `long[][]` is not equal to the given one.

public Long2DArrayAssert isEqualTo(Object expected)

Overrides org.assertj.core.api.AbstractAssert.isEqualTo.

Implements org.assertj.core.api.Assert.isEqualTo.

Verifies that the actual long[][] is equal to the given one.

Warning

This method will use equals to compare (it will compare arrays references only).
Unless you specify a comparator with usingComparator(Comparator), it is advised to use isDeepEqualTo(long[][]) instead.

Example:

 long[][] array = {{1, 2}, {3, 4}};

// assertion will pass
assertThat(array).isEqualTo(array);

// assertion will fail as isEqualTo calls equals which compares arrays references only.
assertThat(array).isEqualTo(new long[][] {{1, 2}, {3, 4}});

Parameters

expected:Object: the given value to compare the actual long[][] to.

Returns:Long2DArrayAssert

this assertion object.

Annotations

@Override

Exceptions

AssertionError:: if the actual long[][] is not equal to the given one.

isNotEmpty back to summary

isNotEmpty	back to summary
public Long2DArrayAssert isNotEmpty() Implements org.assertj.core.api.Array2DAssert.isNotEmpty. Verifies that the actual array is not empty, not empty means the array has at least one element. Example: `// assertions will pass assertThat(new long[][] {{ 1 }, { 2 }}).isNotEmpty(); assertThat(new long[][] {{ }, { 2 }}).isNotEmpty(); // assertions will fail assertThat(new long[][] { }).isNotEmpty(); assertThat(new long[][] {{ }}).isNotEmpty(); // this is considered empty as there are no elements in the 2d array which is comprised of 3 empty rows. assertThat(new long[][] {{ }, { }, { }}).isNotEmpty(); long[][] array = null; assertThat(array).isNotEmpty();` Returns:Long2DArrayAssert `this` assertion object. Annotations @Override Exceptions AssertionError: if the actual array is empty or null.

public Long2DArrayAssert isNotEmpty()

Implements org.assertj.core.api.Array2DAssert.isNotEmpty.

Verifies that the actual array is not empty, not empty means the array has at least one element.

Example:

 // assertions will pass
assertThat(new long[][] {{ 1 }, { 2 }}).isNotEmpty();
assertThat(new long[][] {{ }, { 2 }}).isNotEmpty();

// assertions will fail
assertThat(new long[][] { }).isNotEmpty();
assertThat(new long[][] {{ }}).isNotEmpty();
// this is considered empty as there are no elements in the 2d array which is comprised of 3 empty rows.
assertThat(new long[][] {{ }, { }, { }}).isNotEmpty();
long[][] array = null;
assertThat(array).isNotEmpty();

Returns:Long2DArrayAssert

this assertion object.

Annotations

@Override

Exceptions

AssertionError:: if the actual array is empty or null.

isNullOrEmpty back to summary

isNullOrEmpty	back to summary
public void isNullOrEmpty() Implements org.assertj.core.api.Array2DAssert.isNullOrEmpty. Verifies that the actual array is `null` or empty, empty means the array has no elements, said otherwise it can have any number of rows but all rows must be empty. Example: `// assertions will pass long[][] array = null; assertThat(array).isNullOrEmpty(); assertThat(new long[][] { }).isNullOrEmpty(); assertThat(new long[][] {{ }}).isNullOrEmpty(); // this is considered empty as there are no elements in the 2d array which is comprised of 3 empty rows. assertThat(new long[][] {{ }, { }, { }}).isNullOrEmpty(); // assertion will fail assertThat(new String[][] {{"a"}, {"b"}}).isNullOrEmpty();` Annotations @Override Exceptions AssertionError: if the actual array is not `null` or not empty.

public void isNullOrEmpty()

Implements org.assertj.core.api.Array2DAssert.isNullOrEmpty.

Verifies that the actual array is null or empty, empty means the array has no elements, said otherwise it can have any number of rows but all rows must be empty.

Example:

 // assertions will pass
long[][] array = null;
assertThat(array).isNullOrEmpty();
assertThat(new long[][] { }).isNullOrEmpty();
assertThat(new long[][] {{ }}).isNullOrEmpty();
// this is considered empty as there are no elements in the 2d array which is comprised of 3 empty rows.
assertThat(new long[][] {{ }, { }, { }}).isNullOrEmpty();

// assertion will fail
assertThat(new String[][] {{"a"}, {"b"}}).isNullOrEmpty();

Annotations

@Override

Exceptions

AssertionError:: if the actual array is not null or not empty.

public Class Long2DArrayAssert

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail