AbstractCharArrayAssert (AssertJ fluent assertions 2.2.0 API)

java.lang.Object
- org.assertj.core.api.AbstractAssert<S,A>
- - org.assertj.core.api.AbstractEnumerableAssert<S,A,E>
  - - org.assertj.core.api.AbstractArrayAssert<S,char[],Character>
    - - org.assertj.core.api.AbstractCharArrayAssert<S>

All Implemented Interfaces:

ArraySortedAssert<AbstractArrayAssert<S,char[],Character>,Character>, Assert<S,char[]>, Descriptable<S>, EnumerableAssert<AbstractEnumerableAssert<S,char[],Character>,Character>, ExtensionPoints<S,char[]>

Direct Known Subclasses:

CharArrayAssert
```
public abstract class AbstractCharArrayAssert<S extends AbstractCharArrayAssert<S>>
extends AbstractArrayAssert<S,char[],Character>
```

Field Summary

Fields
Modifier and Type Field and Description

protected CharArrays arrays
- Fields inherited from class org.assertj.core.api.AbstractAssert
  actual, info, myself

Fields
Modifier and Type	Field and Description
`protected CharArrays`	`arrays`

Constructor Summary

Constructors
Constructor and Description

AbstractCharArrayAssert(char[] actual, Class<?> selfType)

Constructors
Constructor and Description
`AbstractCharArrayAssert(char[] actual, Class<?> selfType)`

Method Summary

Methods
Modifier and Type	Method and Description
`S`	`contains(char... values)` Verifies that the actual array contains the given values, in any order.
`S`	`contains(char value, Index index)` Verifies that the actual array contains the given value at the given index.
`S`	`containsExactly(char... values)` Verifies that the actual group contains only the given values and nothing else, in order.
`S`	`containsOnly(char... values)` Verifies that the actual array contains only the given values and nothing else, in any order.
`S`	`containsOnlyOnce(char... values)` Verifies that the actual array contains the given values only once.
`S`	`containsSequence(char... sequence)` Verifies that the actual array contains the given sequence, without any other values between them.
`S`	`containsSubsequence(char... subsequence)` Verifies that the actual array contains the given subsequence (possibly with other values between them).
`S`	`doesNotContain(char... values)` Verifies that the actual array does not contain the given values.
`S`	`doesNotContain(char value, Index index)` Verifies that the actual array does not contain the given value at the given index.
`S`	`doesNotHaveDuplicates()` Verifies that the actual array does not contain duplicates.
`S`	`endsWith(char... sequence)` Verifies that the actual array ends with the given sequence of values, without any other values between them.
`S`	`hasSameSizeAs(Iterable<?> other)` Verifies that the actual group has the same size as given `Iterable`.
`S`	`hasSize(int expected)` Verifies that the number of values in the actual group is equal to the given one.
`S`	`inUnicode()` Use unicode character representation instead of standard representation in error messages.
`void`	`isEmpty()` Verifies that the actual group of values is empty.
`S`	`isNotEmpty()` Verifies that the actual group of values is not empty.
`void`	`isNullOrEmpty()` Verifies that the actual group of values is `null` or empty.
`S`	`isSorted()` Verifies that the actual array is sorted into ascending order according to the natural ordering of its elements.
`S`	`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 element is compatible with comparator, otherwise an AssertionError is thrown.
`S`	`startsWith(char... sequence)` Verifies that the actual array starts with the given sequence of values, without any other values between them.
`S`	`usingDefaultElementComparator()` Revert to standard comparison for incoming assertion group element checks.
`S`	`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.

Methods inherited from class org.assertj.core.api.AbstractEnumerableAssert
hasSameSizeAs, inBinary, inHexadecimal

Methods inherited from class org.assertj.core.api.AbstractAssert
as, as, asList, asString, describedAs, describedAs, descriptionText, doesNotHave, doesNotHaveSameClassAs, equals, failWithMessage, getWritableAssertionInfo, has, hashCode, hasSameClassAs, hasToString, is, isEqualTo, isExactlyInstanceOf, isIn, isIn, isInstanceOf, isInstanceOfAny, isNot, isNotEqualTo, isNotExactlyInstanceOf, isNotIn, isNotIn, isNotInstanceOf, isNotInstanceOfAny, isNotNull, isNotOfAnyClassIn, isNotSameAs, isNull, isOfAnyClassIn, isSameAs, overridingErrorMessage, usingComparator, usingDefaultComparator, withFailMessage, withThreadDumpOnError

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - arrays
```
protected CharArrays arrays
```
- Constructor Detail
  - AbstractCharArrayAssert
```
public AbstractCharArrayAssert(char[] actual,
                       Class<?> selfType)
```
- Method Detail
  - isNullOrEmpty
```
public void isNullOrEmpty()
```
    Verifies that the actual group of values is null or empty.
  - isEmpty
```
public void isEmpty()
```
    Verifies that the actual group of values is empty.
  - isNotEmpty
```
public S isNotEmpty()
```
    Verifies that the actual group of values is not empty.
    
    Returns:
    this assertion object.
  - hasSize
```
public S hasSize(int expected)
```
    Verifies that the number of values in the actual group is equal to the given one.
    Example:
```
 // assertion will pass
 assertThat(new char[] { 'a', 'b', 'c' }).hasSize(3);
 
 // assertion will fail
 assertThat(new char[] { 'a', 'b', 'c', 'd' }).hasSize(3);
```
    Parameters:
    expected - the expected number of values in the actual group.
    
    Returns:
    this assertion object.
  - hasSameSizeAs
```
public S hasSameSizeAs(Iterable<?> other)
```
    Verifies that the actual group has the same size as given 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));
```
    Parameters:
    other - the Iterable to compare size with actual group.
    
    Returns:
    this assertion object.
  - contains
```
public S contains(char... values)
```
    Verifies that the actual array contains the given values, in any order.
    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');
```
    Parameters:
    values - the given values.
    
    Returns:
    this assertion object.
    
    Throws:
    
    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.
  - containsOnly
```
public S containsOnly(char... values)
```
    Verifies that the actual array contains only the given values and nothing else, in any order.
    Example:
```
 // assertion will pass
 assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('a', 'b', 'c');
 assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('b', 'c', 'a');

 // assertion will fail
 * assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('a', 'b', 'c', 'd');
 * assertThat(new char[] { 'a', 'b', 'c' }).containsOnly('d', 'f');
```
    Parameters:
    values - the given values.
    
    Returns:
    this assertion object.
    
    Throws:
    
    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.
  - containsOnlyOnce
```
public S containsOnlyOnce(char... values)
```
    Verifies that the actual array contains the given values only once.
    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');
```
    Parameters:
    values - the given values.
    
    Returns:
    this assertion object.
    
    Throws:
    
    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.
  - containsSequence
```
public S containsSequence(char... sequence)
```
    Verifies that the actual array contains the given sequence, without any other values between them.
    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');
```
    Parameters:
    sequence - the sequence of values to look for.
    
    Returns:
    myself assertion object.
    
    Throws:
    
    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.
  - containsSubsequence
```
public S containsSubsequence(char... subsequence)
```
    Verifies that the actual array contains the given subsequence (possibly with other values between them).
    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');
```
    Parameters:
    subsequence - the subsequence of values to look for.
    
    Returns:
    myself assertion object.
    
    Throws:
    
    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.
  - contains
```
public S contains(char value,
         Index index)
```
    Verifies that the actual array contains the given value at the given 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));
```
    Parameters:
    value - the value to look for.
    index - the index where the value should be stored in the actual array.
    
    Returns:
    myself assertion object.
    
    Throws:
    
    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.
  - doesNotContain
```
public S doesNotContain(char... values)
```
    Verifies that the actual array does not contain the given values.
    Example:
```
 // assertion will pass
 assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('d');
 
 // assertion will fail
 assertThat(new char[] { 'a', 'b', 'c' }).doesNotContain('b');
```
    Parameters:
    values - the given values.
    
    Returns:
    this assertion object.
    
    Throws:
    
    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.
  - doesNotContain
```
public S doesNotContain(char value,
               Index index)
```
    Verifies that the actual array does not contain the given value at the given 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));
```
    Parameters:
    value - the value to look for.
    index - the index where the value should be stored in the actual array.
    
    Returns:
    myself assertion object.
    
    Throws:
    
    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.
  - doesNotHaveDuplicates
```
public S doesNotHaveDuplicates()
```
    Verifies that the actual array does not contain duplicates.
    Example:
```
 // assertion will pass
 assertThat(new char[] { 'a', 'b', 'c' }).doesNotHaveDuplicates();
 
 // assertion will fail
 assertThat(new char[] { 'a', 'a', 'b', 'c' }).doesNotHaveDuplicates();
```
    Returns:
    this assertion object.
    
    Throws:
    
    AssertionError - if the actual array is null.
    
    AssertionError - if the actual array contains duplicates.
  - startsWith
```
public S startsWith(char... sequence)
```
    Verifies that the actual array starts with the given sequence of values, without any other values between them. Similar to containsSequence(char...), 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 char[] { 'a', 'b', 'c' }).startsWith('a', 'b');
 
 // assertion will fail
 assertThat(new char[] { 'a', 'b', 'c' }).startsWith('b', 'c');
```
    Parameters:
    sequence - the sequence of values to look for.
    
    Returns:
    myself assertion object.
    
    Throws:
    
    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.
  - endsWith
```
public S endsWith(char... sequence)
```
    Verifies that the actual array ends with the given sequence of values, without any other values between them. Similar to containsSequence(char...), 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 char[] { 'a', 'b', 'c' }).endsWith('b', 'c');
 
 // assertion will fail
 assertThat(new char[] { 'a', 'b', 'c' }).endsWith('c', 'd');
```
    Parameters:
    sequence - the sequence of values to look for.
    
    Returns:
    myself assertion object.
    
    Throws:
    
    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.
  - isSorted
```
public S isSorted()
```
    Verifies that the actual array is sorted into ascending order according to the natural ordering of its elements.
    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 :
    - a array composed of {2, 4, 6} is ok because the element type is a primitive type.
    - a array composed of {"a1", "a2", "a3"} is ok because the element type (String) is Comparable
    - a array composed of Rectangle {r1, r2, r3} is NOT ok because Rectangle is not Comparable
    - a array composed of {True, "abc", False} is NOT ok because elements are not mutually comparable (even though each element type implements Comparable)
    Empty or one element arrays are considered sorted (unless the array element type is not Comparable).
    Returns:
    this assertion object.
  - isSortedAccordingTo
```
public S 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 element is compatible with comparator, otherwise an AssertionError is thrown.
    
    Parameters:
    comparator - the Comparator used to compare array elements
    
    Returns:
    this assertion object.
  - usingElementComparator
```
public S 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.
    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);
```
    Parameters:
    customComparator - the comparator to use for incoming assertion checks.
    
    Returns:
    this assertion object.
  - usingDefaultElementComparator
```
public S usingDefaultElementComparator()
```
    Revert to standard comparison for incoming assertion group element checks.
    This method should be used to disable a custom comparison strategy set by calling EnumerableAssert.usingElementComparator(Comparator).
    
    Returns:
    this assertion object.
  - containsExactly
```
public S containsExactly(char... values)
```
    Verifies that the actual group contains only the given values and nothing else, in order.
    Example :
```
 // assertion will pass
 assertThat(new char[] { 'a', 'b', 'c' }).containsExactly('a', 'b', 'c');
 
 // assertion will fail as actual and expected orders differ.
 assertThat(new char[] { 'a', 'b', 'c' }).containsExactly('b', 'a', 'c');
```
    Parameters:
    values - the given values.
    
    Returns:
    this assertion object.
    
    Throws:
    
    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.
  - inUnicode
```
public S inUnicode()
```
    Use unicode character representation instead of standard representation in error messages.
    With standard error message:
```
 assertThat("a6c".toCharArray()).isEqualTo("abó".toCharArray());

 org.junit.ComparisonFailure:
 Expected :['a', 'b', 'ó']
 Actual   :[a, 6, c]
```
    With unicode based error message:
```
 assertThat("a6c".toCharArray()).inUnicode().isEqualTo("abó".toCharArray());

 org.junit.ComparisonFailure:
 Expected :[a, b, ó]
 Actual   :[a, 6, c]
```
    Returns:
    this assertion object.

Class AbstractCharArrayAssert<S extends AbstractCharArrayAssert<S>>

Field Summary

Fields inherited from class org.assertj.core.api.AbstractAssert

Constructor Summary

Method Summary

Methods inherited from class org.assertj.core.api.AbstractEnumerableAssert

Methods inherited from class org.assertj.core.api.AbstractAssert

Methods inherited from class java.lang.Object

Field Detail

arrays

Constructor Detail

AbstractCharArrayAssert

Method Detail

isNullOrEmpty

isEmpty

isNotEmpty

hasSize

hasSameSizeAs

contains

containsOnly

containsOnlyOnce

containsSequence

containsSubsequence

contains

doesNotContain

doesNotContain

doesNotHaveDuplicates

startsWith

endsWith

isSorted

isSortedAccordingTo

usingElementComparator

usingDefaultElementComparator

containsExactly

inUnicode