public abstract class AbstractCharArrayAssert<SELF extends AbstractCharArrayAssert<SELF>> extends AbstractArrayAssert<SELF,char[],Character>
| Modifier and Type | Field and Description |
|---|---|
protected CharArrays |
arrays |
actual, info, myself, throwUnsupportedExceptionOnEquals| Constructor and Description |
|---|
AbstractCharArrayAssert(char[] actual,
Class<?> selfType) |
| Modifier and Type | Method and Description |
|---|---|
SELF |
contains(char... values)
Verifies that the actual array contains the given values, in any order.
|
SELF |
contains(char value,
Index index)
Verifies that the actual array contains the given value at the given index.
|
SELF |
containsAnyOf(char... values)
Verifies that the actual array contains at least one of the given values.
|
SELF |
containsExactly(char... values)
Verifies that the actual group contains only the given values and nothing else, in order.
|
SELF |
containsExactlyInAnyOrder(char... values)
Verifies that the actual group contains exactly the given values and nothing else, in any order.
|
SELF |
containsOnly(char... values)
Verifies that the actual array contains only the given values and nothing else, in any order.
|
SELF |
containsOnlyOnce(char... values)
Verifies that the actual array contains the given values only once.
|
SELF |
containsSequence(char... sequence)
Verifies that the actual array contains the given sequence, without any other values between them.
|
SELF |
containsSubsequence(char... subsequence)
Verifies that the actual array contains the given subsequence (possibly with other values between them).
|
SELF |
doesNotContain(char... values)
Verifies that the actual array does not contain the given values.
|
SELF |
doesNotContain(char 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(char... 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 group 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.
|
SELF |
inUnicode()
Use unicode character representation instead of standard representation in error messages.
|
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 Character> 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(char... 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 Character> customComparator)
Use given custom comparator instead of relying on actual type A
equals method to compare group
elements for incoming assertion checks. |
hasSameSizeAs, inBinary, inHexadecimalas, 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, withThreadDumpOnErrorprotected CharArrays arrays
public AbstractCharArrayAssert(char[] 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);Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).hasSize(3);
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c', 'd' }).hasSize(3);expected - the expected number of values in the actual group.this assertion object.public SELF hasSizeGreaterThan(int boundary)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b' }).hasSizeGreaterThan(1);
// assertion will fail
assertThat(new char[] { 'a' }).hasSizeGreaterThan(1);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:
// assertion will pass
assertThat(new char[] { 'a', 'b' }).hasSizeGreaterThanOrEqualTo(1)
.hasSizeGreaterThanOrEqualTo(2);
// assertion will fail
assertThat(new char[] { 'a' }).hasSizeGreaterThanOrEqualTo(2);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 char[] { 'a', 'b' }).hasSizeLessThan(3);
// assertion will fail
assertThat(new char[] { 'a', 'b' }).hasSizeLessThan(1);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:
// assertion will pass
assertThat(new char[] { 'a', 'b' }).hasSizeLessThanOrEqualTo(3)
.hasSizeLessThanOrEqualTo(2);
// assertion will fail
assertThat(new char[] { 'a', 'b' }).hasSizeLessThanOrEqualTo(1);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:
// assertion will pass
assertThat(new char[] { 'a', 'b' }).hasSizeBetween(1, 3)
.hasSizeBetween(2, 2);
// assertion will fail
assertThat(new char[] { 'a', 'b' }).hasSizeBetween(4, 5);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:
// assertion will pass
assertThat(new char[] { 'a', 'b' }).hasSameSizeAs(Arrays.asList(1, 2));
// assertion will fail
assertThat(new char[] { 'a', 'b' }).hasSameSizeAs(Arrays.asList(1, 2, 3));other - the Iterable to compare size with actual group.this assertion object.public SELF contains(char... values)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).contains('a', 'b');
assertThat(new char[] { 'a', 'b', 'c' }).contains('c', 'a');
assertThat(new char[] { 'a', 'b', 'c' }).contains('a', 'c', 'b');
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).contains('a', 'd');
assertThat(new char[] { 'a', 'b', 'c' }).contains('d', 'f');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(char... values)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('a', 'b', 'c');
assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('b', 'c', 'a');
assertThat(new char[] { 'a', 'a', 'b' }).containsOnly('a', 'b');
// assertion will fail
* assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('a', 'b', 'c', 'd');
* assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('d', 'f');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(char... values)
Examples :
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).containsOnlyOnce('a', 'b');
// assertions will fail
assertThat(new char[] { 'a', 'b', 'a' }).containsOnlyOnce('a');
assertThat(new char[] { 'a', 'b', 'c' }).containsOnlyOnce('d');
assertThat(new char[] { 'a', 'b', 'c', 'c' }).containsOnlyOnce('0', 'a', 'b', 'c', 'd', 'e');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(char... sequence)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).containsSequence('a', 'b');
assertThat(new char[] { 'a', 'b', 'c' }).containsSequence('a', 'b', 'c');
assertThat(new char[] { 'a', 'b', 'c' }).containsSequence('b', 'c');
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).containsSequence('c', 'a');
assertThat(new char[] { 'a', 'b', 'c' }).containsSequence('d', 'f');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(char... subsequence)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).containsSubsequence('a', 'b');
assertThat(new char[] { 'a', 'b', 'c' }).containsSubsequence('a', 'c');
assertThat(new char[] { 'a', 'b', 'c' }).containsSubsequence('b', 'c');
assertThat(new char[] { 'a', 'b', 'c' }).containsSubsequence('a', 'b', 'c');
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).containsSubsequence('c', 'a');
assertThat(new char[] { 'a', 'b', 'c' }).containsSubsequence('d', 'f');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(char value, Index index)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).contains('a', atIndex(O));
assertThat(new char[] { 'a', 'b', 'c' }).contains('c', atIndex(2));
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).contains('a', atIndex(1));
assertThat(new char[] { 'a', 'b', 'c' }).contains('d', 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(char... values)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('d');
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('b');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(char value, Index index)
Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('a', atIndex(1));
assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('b', atIndex(0));
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('a', atIndex(0));
assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('b', 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 char[] { 'a', 'b', 'c' }).doesNotHaveDuplicates();
// assertion will fail
assertThat(new char[] { 'a', 'a', 'b', 'c' }).doesNotHaveDuplicates();this assertion object.AssertionError - if the actual array is null.AssertionError - if the actual array contains duplicates.public SELF startsWith(char... sequence)
containsSequence(char...)Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).startsWith('a', 'b');
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).startsWith('b', 'c');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(char... sequence)
containsSequence(char...)Example:
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).endsWith('b', 'c');
// assertion will fail
assertThat(new char[] { 'a', 'b', 'c' }).endsWith('c', 'd');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 Character> comparator)
comparator - the Comparator used to compare array elementsthis assertion object.public SELF usingElementComparator(Comparator<? super Character> 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(char... values)
Example :
// assertion will pass
assertThat(new char[] { 'a', 'b', 'c' }).containsExactly('a', 'b', 'c');
// assertion will fail as actual and expected order differ
assertThat(new char[] { 'a', 'b', 'c' }).containsExactly('b', 'a', 'c');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(char... values)
Example :
// assertions will pass
assertThat(new char[] { 'a', 'b' }).containsExactlyInAnyOrder('b', 'a');
assertThat(new char[] { 'a', 'b', 'a' }).containsExactlyInAnyOrder('a', 'a', 'b');
// assertions will fail
assertThat(new char[] { 'a', 'b' }).containsExactlyInAnyOrder('a');
assertThat(new char[] { 'a' }).containsExactlyInAnyOrder('a', 'b');
assertThat(new char[] { 'a', 'b', 'a' }).containsExactlyInAnyOrder('a', 'b');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 inUnicode()
With standard error message:
assertThat("a6c".toCharArray()).isEqualTo("abó".toCharArray());
org.junit.ComparisonFailure:
Expected :['a', 'b', 'ó']
Actual :[a, 6, c] assertThat("a6c".toCharArray()).inUnicode().isEqualTo("abó".toCharArray());
org.junit.ComparisonFailure:
Expected :[a, b, ó]
Actual :[a, 6, c]this assertion object.public SELF containsAnyOf(char... values)
Example :
char[] abc = { 'a', 'b', 'c' };
// assertions will pass
assertThat(abc).containsAnyOf('b')
.containsAnyOf('b', 'c')
.containsAnyOf('a', 'b', 'c')
.containsAnyOf('a', 'b', 'c', 'd')
.containsAnyOf('e', 'f', 'g', 'b');
// assertions will fail
assertThat(abc).containsAnyOf('d');
assertThat(abc).containsAnyOf('d', 'e', 'f', 'g');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.