public abstract class AbstractLongArrayAssert<SELF extends AbstractLongArrayAssert<SELF>> extends AbstractArrayAssert<SELF,long[],Long>
Modifier and Type | Field and Description |
---|---|
protected LongArrays |
arrays |
actual, info, myself, throwUnsupportedExceptionOnEquals
Constructor and Description |
---|
AbstractLongArrayAssert(long[] actual,
Class<?> selfType) |
Modifier and Type | Method and Description |
---|---|
SELF |
contains(long... values)
Verifies that the actual array contains the given values, in any order.
|
SELF |
contains(long value,
Index index)
Verifies that the actual array contains the given value at the given index.
|
SELF |
containsAnyOf(long... values)
Verifies that the actual array contains at least one of the given values.
|
SELF |
containsExactly(long... values)
Verifies that the actual group contains only the given values and nothing else, in order.
|
SELF |
containsExactlyInAnyOrder(long... values)
Verifies that the actual group contains exactly the given values and nothing else, in any order.
|
SELF |
containsOnly(long... values)
Verifies that the actual array contains only the given values and nothing else, in any order.
|
SELF |
containsOnlyOnce(long... values)
Verifies that the actual array contains the given values only once.
|
SELF |
containsSequence(long... sequence)
Verifies that the actual array contains the given sequence, without any other values between them.
|
SELF |
containsSubsequence(long... subsequence)
Verifies that the actual array contains the given subsequence (possibly with other values between them).
|
SELF |
doesNotContain(long... values)
Verifies that the actual array does not contain the given values.
|
SELF |
doesNotContain(long value,
Index index)
Verifies that the actual array does not contain the given value at the given index.
|
SELF |
doesNotHaveDuplicates()
Verifies that the actual array does not contain duplicates.
|
SELF |
endsWith(long... sequence)
Verifies that the actual array ends with the given sequence of values, without any other values between them.
|
SELF |
hasSameSizeAs(Iterable<?> other)
Verifies that the actual group has the same size as given
Iterable . |
SELF |
hasSize(int expected)
Verifies that the number of values in the actual group is equal to the given one.
|
SELF |
hasSizeBetween(int lowerBoundary,
int higherBoundary)
Verifies that the number of values in the actual array is between the given boundaries (inclusive).
|
SELF |
hasSizeGreaterThan(int boundary)
Verifies that the number of values in the actual array is greater than the given boundary.
|
SELF |
hasSizeGreaterThanOrEqualTo(int boundary)
Verifies that the number of values in the actual array is greater than or equal to the given boundary.
|
SELF |
hasSizeLessThan(int boundary)
Verifies that the number of values in the actual array is less than the given boundary.
|
SELF |
hasSizeLessThanOrEqualTo(int boundary)
Verifies that the number of values in the actual array is less than or equal to the given boundary.
|
void |
isEmpty()
Verifies that the actual group of values is empty.
|
SELF |
isNotEmpty()
Verifies that the actual group of values is not empty.
|
void |
isNullOrEmpty()
Verifies that the actual group of values is
null or empty. |
SELF |
isSorted()
Verifies that the actual array is sorted in ascending order according to the natural ordering of its elements.
|
SELF |
isSortedAccordingTo(Comparator<? super Long> comparator)
Verifies that the actual array is sorted according to the given comparator.
Empty arrays are considered sorted whatever the comparator is. One element arrays are considered sorted if the element is compatible with comparator, otherwise an AssertionError is thrown. |
SELF |
startsWith(long... sequence)
Verifies that the actual array starts with the given sequence of values, without any other values between them.
|
SELF |
usingDefaultElementComparator()
Revert to standard comparison for incoming assertion group element checks.
|
SELF |
usingElementComparator(Comparator<? super Long> customComparator)
Use given custom comparator instead of relying on actual type A
equals method to compare group
elements for incoming assertion checks. |
hasSameSizeAs, inBinary, inHexadecimal
as, as, asList, asString, describedAs, describedAs, descriptionText, doesNotHave, doesNotHaveSameClassAs, equals, failWithMessage, getWritableAssertionInfo, has, hashCode, hasSameClassAs, hasSameHashCodeAs, hasToString, is, isEqualTo, isExactlyInstanceOf, isIn, isIn, isInstanceOf, isInstanceOfAny, isInstanceOfSatisfying, isNot, isNotEqualTo, isNotExactlyInstanceOf, isNotIn, isNotIn, isNotInstanceOf, isNotInstanceOfAny, isNotNull, isNotOfAnyClassIn, isNotSameAs, isNull, isOfAnyClassIn, isSameAs, matches, matches, newListAssertInstance, overridingErrorMessage, satisfies, satisfies, satisfiesAnyOf, satisfiesAnyOf, setCustomRepresentation, throwAssertionError, usingComparator, usingComparator, usingDefaultComparator, withFailMessage, withRepresentation, withThreadDumpOnError
protected LongArrays arrays
public AbstractLongArrayAssert(long[] actual, Class<?> selfType)
public void isNullOrEmpty()
null
or empty.
Example:
// assertions will pass
List<String> strings = new ArrayList<>();
assertThat(strings).isNullOrEmpty();
assertThat(new int[] { }).isNullOrEmpty();
// assertions will fail
assertThat(new String[] { "a", "b"}).isNullOrEmpty();
assertThat(Arrays.asList(1, 2, 3)).isNullOrEmpty();
public void isEmpty()
Example:
// assertions will pass
assertThat(new ArrayList()).isEmpty();
assertThat(new int[] { }).isEmpty();
// assertions will fail
assertThat(new String[] { "a", "b" }).isEmpty();
assertThat(Arrays.asList(1, 2, 3)).isEmpty();
public SELF isNotEmpty()
Example:
// assertions will pass
assertThat(new String[] { "a", "b" }).isNotEmpty();
assertThat(Arrays.asList(1, 2, 3)).isNotEmpty();
// assertions will fail
assertThat(new ArrayList()).isNotEmpty();
assertThat(new int[] { }).isNotEmpty();
this
assertion object.public SELF hasSize(int expected)
Example:
// assertions will pass
assertThat(new String[] { "a", "b" }).hasSize(2);
assertThat(Arrays.asList(1, 2, 3)).hasSize(3);
// assertions will fail
assertThat(new ArrayList()).hasSize(1);
assertThat(new int[] { 1, 2, 3 }).hasSize(2);
expected
- the expected number of values in the actual group.this
assertion object.public SELF hasSizeGreaterThan(int boundary)
Example:
// assertion will pass
assertThat(new long[] { 1, 2, 3 }).hasSizeGreaterThan(2);
// assertion will fail
assertThat(new long[] { 1, 2, 3 }).hasSizeGreaterThan(6);
boundary
- the given value to compare the actual size to.this
assertion object.AssertionError
- if the number of values of the actual array is not greater than the boundary.public SELF hasSizeGreaterThanOrEqualTo(int boundary)
Example:
// assertions will pass
assertThat(new long[] { 1, 2, 3 }).hasSizeGreaterThanOrEqualTo(2)
.hasSizeGreaterThanOrEqualTo(3);
// assertion will fail
assertThat(new long[] { 1, 2, 3 }).hasSizeGreaterThanOrEqualTo(4);
boundary
- the given value to compare the actual size to.this
assertion object.AssertionError
- if the number of values of the actual array is not greater than or equal to the boundary.public SELF hasSizeLessThan(int boundary)
Example:
// assertion will pass
assertThat(new long[] { 1, 2, 3 }).hasSizeLessThan(5);
// assertion will fail
assertThat(new long[] { 1, 2, 3 }).hasSizeLessThan(4);
boundary
- the given value to compare the actual size to.this
assertion object.AssertionError
- if the number of values of the actual array is not less than the boundary.public SELF hasSizeLessThanOrEqualTo(int boundary)
Example:
// assertions will pass
assertThat(new long[] { 1, 2, 3 }).hasSizeLessThanOrEqualTo(5)
.hasSizeLessThanOrEqualTo(3);
// assertions will fail
assertThat(new long[] { 1, 2, 3 }).hasSizeLessThanOrEqualTo(4);
boundary
- the given value to compare the actual size to.this
assertion object.AssertionError
- if the number of values of the actual array is not less than or equal to the boundary.public SELF hasSizeBetween(int lowerBoundary, int higherBoundary)
Example:
// assertions will pass
assertThat(new long[] { 1, 2, 3 }).hasSizeBetween(0, 4)
.hasSizeBetween(3, 3);
// assertions will fail
assertThat(new long[] { 1, 2, 3 }).hasSizeBetween(4, 6);
assertThat(new long[] { 1, 2, 3 }).hasSizeBetween(0, 2);
lowerBoundary
- the lower boundary compared to which actual size should be greater than or equal to.higherBoundary
- the higher boundary compared to which actual size should be less than or equal to.this
assertion object.AssertionError
- if the number of values of the actual array is not between the boundaries.public SELF hasSameSizeAs(Iterable<?> other)
Iterable
.
Example:
Iterable<String> abc = newArrayList("a", "b", "c");
Iterable<Ring> elvesRings = newArrayList(vilya, nenya, narya);
// assertion will pass
assertThat(elvesRings).hasSameSizeAs(abc);
// assertions will fail
assertThat(elvesRings).hasSameSizeAs(Arrays.asList(1, 2));
assertThat(elvesRings).hasSameSizeAs(Arrays.asList(1, 2, 3, 4));
other
- the Iterable
to compare size with actual group.this
assertion object.public SELF contains(long... values)
Example:
// assertions will pass
assertThat(new long[] { 1L, 2L, 3L }).contains(1L, 2L);
assertThat(new long[] { 1L, 2L, 3L }).contains(3L, 1L);
assertThat(new long[] { 1L, 2L, 3L }).contains(1L, 3L, 2L);
// assertions will fail
assertThat(new long[] { 1L, 2L, 3L }).contains(1L, 4L);
assertThat(new long[] { 1L, 2L, 3L }).contains(4L, 7L);
values
- the given values.this
assertion object.NullPointerException
- if the given argument is null
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the actual array is null
.AssertionError
- if the actual array does not contain the given values.public SELF containsOnly(long... values)
Example:
// assertions will pass
assertThat(new long[] { 1L, 2L, 3L }).containsOnly(1L, 2L, 3L);
assertThat(new long[] { 1L, 2L, 3L }).containsOnly(2L, 3L, 1L);
assertThat(new long[] { 1L, 1L, 2L }).containsOnly(1L, 2L);
// assertions will fail
assertThat(new long[] { 1L, 2L, 3L }).containsOnly(1L, 2L, 3L, 4L);
assertThat(new long[] { 1L, 2L, 3L }).containsOnly(4L, 7L);
values
- the given values.this
assertion object.NullPointerException
- if the given argument is null
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the actual array is null
.AssertionError
- if the actual array does not contain the given values, i.e. the actual array contains some
or none of the given values, or the actual array contains more values than the given ones.public SELF containsOnlyOnce(long... values)
Examples :
// assertion will pass
assertThat(new long[] { 1, 2, 3 }).containsOnlyOnce(1, 2);
// assertions will fail
assertThat(new long[] { 1, 2, 1 }).containsOnlyOnce(1);
assertThat(new long[] { 1, 2, 3 }).containsOnlyOnce(4);
assertThat(new long[] { 1, 2, 3, 3 }).containsOnlyOnce(0, 1, 2, 3, 4, 5);
values
- the given values.this
assertion object.NullPointerException
- if the given argument is null
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the actual array is null
.AssertionError
- if the actual group does not contain the given values, i.e. the actual group contains some
or none of the given values, or the actual group contains more than once these values.public SELF containsSequence(long... sequence)
Example:
// assertion will pass
assertThat(new long[] { 1, 2, 3 }).containsSequence(1, 2);
// assertion will fail
assertThat(new long[] { 1, 2, 3 }).containsSequence(1, 3);
assertThat(new long[] { 1, 2, 3 }).containsSequence(2, 1);
sequence
- the sequence of values to look for.AssertionError
- if the actual array is null
.AssertionError
- if the given array is null
.AssertionError
- if the actual array does not contain the given sequence.public SELF containsSubsequence(long... subsequence)
Example:
// assertion will pass
assertThat(new long[] { 1, 2, 3 }).containsSubsequence(1, 2);
assertThat(new long[] { 1, 2, 3 }).containsSubsequence(1, 3);
// assertion will fail
assertThat(new long[] { 1, 2, 3 }).containsSubsequence(2, 1);
subsequence
- the subsequence of values to look for.AssertionError
- if the actual array is null
.AssertionError
- if the given array is null
.AssertionError
- if the actual array does not contain the given subsequence.public SELF contains(long value, Index index)
Example:
// assertions will pass
assertThat(new long[] { 1L, 2L, 3L }).contains(1L, atIndex(O));
assertThat(new long[] { 1L, 2L, 3L }).contains(3L, atIndex(2));
// assertions will fail
assertThat(new long[] { 1L, 2L, 3L }).contains(1L, atIndex(1));
assertThat(new long[] { 1L, 2L, 3L }).contains(4L, atIndex(2));
value
- the value to look for.index
- the index where the value should be stored in the actual array.AssertionError
- if the actual array is null
or empty.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.AssertionError
- if the actual array does not contain the given value at the given index.public SELF doesNotContain(long... values)
Example:
// assertion will pass
assertThat(new long[] { 1L, 2L, 3L }).doesNotContain(4L);
// assertion will fail
assertThat(new long[] { 1L, 2L, 3L }).doesNotContain(2L);
values
- the given values.this
assertion object.NullPointerException
- if the given argument is null
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the actual array is null
.AssertionError
- if the actual array contains any of the given values.public SELF doesNotContain(long value, Index index)
Example:
// assertions will pass
assertThat(new long[] { 1L, 2L, 3L }).doesNotContain(1L, atIndex(1));
assertThat(new long[] { 1L, 2L, 3L }).doesNotContain(2L, atIndex(0));
// assertions will fail
assertThat(new long[] { 1L, 2L, 3L }).doesNotContain(1L, atIndex(0));
assertThat(new long[] { 1L, 2L, 3L }).doesNotContain(2L, atIndex(1));
value
- the value to look for.index
- the index where the value should be stored in the actual array.AssertionError
- if the actual array is null
.NullPointerException
- if the given Index
is null
.AssertionError
- if the actual array contains the given value at the given index.public SELF doesNotHaveDuplicates()
Example:
// assertion will pass
assertThat(new long[] { 1L, 2L, 3L }).doesNotHaveDuplicates();
// assertion will fail
assertThat(new long[] { 1L, 1L, 2L, 3L }).doesNotHaveDuplicates();
this
assertion object.AssertionError
- if the actual array is null
.AssertionError
- if the actual array contains duplicates.public SELF startsWith(long... sequence)
containsSequence(long...)
, but it also verifies that the first element in the
sequence is also first element of the actual array.
Example:
// assertion will pass
assertThat(new long[] { 1L, 2L, 3L }).startsWith(1L, 2L);
// assertion will fail
assertThat(new long[] { 1L, 2L, 3L }).startsWith(2L, 3L);
sequence
- the sequence of values to look for.NullPointerException
- if the given argument is null
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the actual array is null
.AssertionError
- if the actual array does not start with the given sequence.public SELF endsWith(long... sequence)
containsSequence(long...)
, but it also verifies that the last element in the
sequence is also last element of the actual array.
Example:
// assertion will pass
assertThat(new long[] { 1L, 2L, 3L }).endsWith(2L, 3L);
// assertion will fail
assertThat(new long[] { 1L, 2L, 3L }).endsWith(3L, 4L);
sequence
- the sequence of values to look for.NullPointerException
- if the given argument is null
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the actual array is null
.AssertionError
- if the actual array does not end with the given sequence.public SELF isSorted()
All array elements must be primitive or implement the Comparable
interface and must be mutually comparable (that is,
e1.compareTo(e2) must not throw a ClassCastException for any elements e1 and e2 in the array), examples :
this
assertion object.public SELF isSortedAccordingTo(Comparator<? super Long> comparator)
comparator
- the Comparator
used to compare array elementsthis
assertion object.public SELF usingElementComparator(Comparator<? super Long> customComparator)
equals
method to compare group
elements for incoming assertion checks.
Custom comparator is bound to assertion instance, meaning that if a new assertion is created, it will use default comparison strategy.
Examples : // compares invoices by payee
assertThat(invoiceList).usingComparator(invoicePayeeComparator).isEqualTo(expectedInvoiceList);
// compares invoices by date, doesNotHaveDuplicates and contains both use the given invoice date comparator
assertThat(invoiceList).usingComparator(invoiceDateComparator).doesNotHaveDuplicates().contains(may2010Invoice);
// as assertThat(invoiceList) creates a new assertion, it falls back to standard comparison strategy
// based on Invoice's equal method to compare invoiceList elements to lowestInvoice.
assertThat(invoiceList).contains(lowestInvoice);
// standard comparison : the fellowshipOfTheRing includes Gandalf but not Sauron (believe me) ...
assertThat(fellowshipOfTheRing).contains(gandalf)
.doesNotContain(sauron);
// ... but if we compare only races, Sauron is in fellowshipOfTheRing because he's a Maia like Gandalf.
assertThat(fellowshipOfTheRing).usingElementComparator(raceComparator)
.contains(sauron);
customComparator
- the comparator to use for incoming assertion checks.this
assertion object.public SELF usingDefaultElementComparator()
This method should be used to disable a custom comparison strategy set by calling
EnumerableAssert.usingElementComparator(Comparator)
.
this
assertion object.public SELF containsExactly(long... values)
Example :
long[] longs = { 1, 2, 3 };
// assertion will pass
assertThat(longs).containsExactly(1, 2, 3);
// assertion will fail as actual and expected order differ
assertThat(longs).containsExactly(2, 1, 3);
values
- the given values.this
assertion object.NullPointerException
- if the given argument is null
.AssertionError
- if the actual group is null
.AssertionError
- if the actual group does not contain the given values with same order, i.e. the actual group
contains some or none of the given values, or the actual group contains more values than the given ones
or values are the same but the order is not.public SELF containsExactlyInAnyOrder(long... values)
Example :
// assertions will pass
assertThat(new long[] { 1L, 2L }).containsExactlyInAnyOrder(1L, 2L);
assertThat(new long[] { 1L, 2L, 1L }).containsExactlyInAnyOrder(1L, 1L, 2L);
// assertions will fail
assertThat(new long[] { 1L, 2L }).containsExactlyInAnyOrder(1L);
assertThat(new long[] { 1L }).containsExactlyInAnyOrder(1L, 2L);
assertThat(new long[] { 1L, 2L, 1L }).containsExactlyInAnyOrder(1L, 2L);
values
- the given values.this
assertion object.NullPointerException
- if the given argument is null
.AssertionError
- if the actual group is null
.AssertionError
- if the actual group does not contain the given values, i.e. the actual group
contains some or none of the given values, or the actual group contains more values than the given ones.public SELF containsAnyOf(long... values)
Example :
long[] oneTwoThree = { 1L, 2L, 3L };
// assertions will pass
assertThat(oneTwoThree).containsAnyOf(2L)
.containsAnyOf(2L, 3L)
.containsAnyOf(1L, 2L, 3L)
.containsAnyOf(1L, 2L, 3L, 4L)
.containsAnyOf(5L, 6L, 7L, 2L);
// assertions will fail
assertThat(oneTwoThree).containsAnyOf(4L);
assertThat(oneTwoThree).containsAnyOf(4L, 5L, 6L, 7L);
values
- the values whose at least one which is expected to be in the array under test.this
assertion object.NullPointerException
- if the array of values is null
.IllegalArgumentException
- if the array of values is empty and the array under test is not empty.AssertionError
- if the array under test is null
.AssertionError
- if the array under test does not contain any of the given values
.Copyright © 2014–2019 AssertJ. All rights reserved.