AbstractLongAssert (AssertJ fluent assertions 2.6.0 API)

java.lang.Object
- org.assertj.core.api.AbstractAssert<S,A>
- - org.assertj.core.api.AbstractObjectAssert<S,A>
  - - org.assertj.core.api.AbstractComparableAssert<S,Long>
    - - org.assertj.core.api.AbstractLongAssert<S>

Type Parameters:
S - the "self" type of this assertion class. Please read "Emulating 'self types' using Java Generics to simplify fluent API implementation" for more details.

All Implemented Interfaces:

Assert<S,Long>, ComparableAssert<S,Long>, Descriptable<S>, ExtensionPoints<S,Long>, NumberAssert<S,Long>

Direct Known Subclasses:

LongAssert
```
public abstract class AbstractLongAssert<S extends AbstractLongAssert<S>>
extends AbstractComparableAssert<S,Long>
implements NumberAssert<S,Long>
```
Base class for all implementations of assertions for Longs.

Author:

Yvonne Wang, David DIDIER, Ansgar Konermann, Alex Ruiz, Joel Costigliola, Mikhail Mazursky, Nicolas François

Field Summary
- Fields inherited from class org.assertj.core.api.AbstractAssert
  actual, info, myself

Constructor Summary

Constructors
Constructor and Description

AbstractLongAssert(Long actual, Class<?> selfType)

Constructors
Constructor and Description
`AbstractLongAssert(Long actual, Class<?> selfType)`

Method Summary

Methods
Modifier and Type	Method and Description
`S`	`isBetween(Long start, Long end)` Verifies that the actual value is in [start, end] range (start included, end included).
`S`	`isCloseTo(long expected, Offset<Long> offset)` Verifies that the actual long is close to the given one within the given offset. If difference is equal to offset value, assertion is considered valid.
`S`	`isCloseTo(Long expected, Offset<Long> offset)` Verifies that the actual long is close to the given one within the given offset. If difference is equal to offset value, assertion is considered valid.
`S`	`isCloseTo(long expected, Percentage percentage)` Verifies that the actual number is close to the given one within the given percentage. If difference is equal to the percentage value, assertion is considered valid.
`S`	`isCloseTo(Long expected, Percentage percentage)` Verifies that the actual number is close to the given one within the given percentage. If difference is equal to the percentage value, assertion is considered valid.
`S`	`isEqualTo(long expected)` Verifies that the actual value is equal to the given one.
`S`	`isGreaterThan(long other)` Verifies that the actual value is greater than the given one.
`S`	`isGreaterThanOrEqualTo(long other)` Verifies that the actual value is greater than or equal to the given one.
`S`	`isLessThan(long other)` Verifies that the actual value is less than the given one.
`S`	`isLessThanOrEqualTo(long other)` Verifies that the actual value is less than or equal to the given one.
`S`	`isNegative()` Verifies that the actual value is negative.
`S`	`isNotCloseTo(long expected, Offset<Long> offset)` Verifies that the actual long is not close to the given one by less than the given offset. If the difference is equal to the offset value, the assertion fails.
`S`	`isNotCloseTo(Long expected, Offset<Long> offset)` Verifies that the actual long is not close to the given one by less than the given offset. If the difference is equal to the offset value, the assertion fails.
`S`	`isNotCloseTo(long expected, Percentage percentage)` Verifies that the actual number is not close to the given one within the given percentage. If difference is equal to the percentage value, the assertion fails.
`S`	`isNotCloseTo(Long expected, Percentage percentage)` Verifies that the actual number is not close to the given one within the given percentage. If difference is equal to the percentage value, the assertion fails.
`S`	`isNotEqualTo(long other)` Verifies that the actual value is not equal to the given one.
`S`	`isNotNegative()` Verifies that the actual value is non negative (positive or equal zero).
`S`	`isNotPositive()` Verifies that the actual value is non positive (negative or equal zero).
`S`	`isNotZero()` Verifies that the actual value is not equal to zero.
`S`	`isPositive()` Verifies that the actual value is positive.
`S`	`isStrictlyBetween(Long start, Long end)` Verifies that the actual value is in ]start, end[ range (start excluded, end excluded).
`S`	`isZero()` Verifies that the actual value is equal to zero.
`S`	`usingComparator(Comparator<? super Long> customComparator)` Use given custom comparator instead of relying on actual type A equals method for incoming assertion checks.
`S`	`usingDefaultComparator()` Revert to standard comparison for incoming assertion checks.

Methods inherited from class org.assertj.core.api.AbstractComparableAssert
inBinary, inHexadecimal, isEqualByComparingTo, isGreaterThan, isGreaterThanOrEqualTo, isLessThan, isLessThanOrEqualTo, isNotEqualByComparingTo

Methods inherited from class org.assertj.core.api.AbstractObjectAssert
as, as, defaultTypeComparators, extracting, hasFieldOrProperty, hasFieldOrPropertyWithValue, hasNoNullFieldsOrProperties, hasNoNullFieldsOrPropertiesExcept, isEqualToComparingFieldByField, isEqualToComparingFieldByFieldRecursively, isEqualToComparingOnlyGivenFields, isEqualToIgnoringGivenFields, isEqualToIgnoringNullFields, usingComparatorForFields, usingComparatorForType

Methods inherited from class org.assertj.core.api.AbstractAssert
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, setCustomRepresentation, withFailMessage, withRepresentation, withThreadDumpOnError

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

- Constructor Detail
  - AbstractLongAssert
```
public AbstractLongAssert(Long actual,
                  Class<?> selfType)
```
- Method Detail
  - isEqualTo
```
public S isEqualTo(long expected)
```
    Verifies that the actual value is equal to the given one.
    Example:
```
 // assertions will pass:
 assertThat(1L).isEqualTo(1L);
 assertThat(-1L).isEqualTo(-1L);
 
 // assertions will fail:
 assertThat(1L).isEqualTo(2L);
 assertThat(1L).isEqualTo(-1L);
```
    Parameters:
    expected - the given value to compare the actual value to.
    
    Returns:
    this assertion object.
    
    Throws:
    
    AssertionError - if the actual value is null.
    
    AssertionError - if the actual value is not equal to the given one.
  - isNotEqualTo
```
public S isNotEqualTo(long other)
```
    Verifies that the actual value is not equal to the given one.
    Example:
```
 // assertions will pass:
 assertThat(1L).isNotEqualTo(2L);
 assertThat(1L).isNotEqualTo(-1L);
 
 // assertion will fail:
 assertThat(1L).isNotEqualTo(1L);
```
    Parameters:
    other - the given value to compare the actual value to.
    
    Returns:
    this assertion object.
    
    Throws:
    
    AssertionError - if the actual value is null.
    
    AssertionError - if the actual value is equal to the given one.
  - isZero
```
public S isZero()
```
    Verifies that the actual value is equal to zero.
    Example:
```
 // assertions will pass
 assertThat(0).isZero();
 assertThat(0.0).isZero();

 // assertions will fail
 assertThat(42).isZero();
 assertThat(3.142).isZero();
```
    Specified by:
    
    isZero in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Returns:
    this assertion object.
  - isNotZero
```
public S isNotZero()
```
    Verifies that the actual value is not equal to zero.
    Example:
```
 // assertions will pass
 assertThat(42).isNotZero();
 assertThat(3.142).isNotZero();

 // assertions will fail
 assertThat(0).isNotZero();
 assertThat(0.0).isNotZero();
```
    Specified by:
    
    isNotZero in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Returns:
    this assertion object.
  - isPositive
```
public S isPositive()
```
    Verifies that the actual value is positive.
    Example:
```
 // assertions will pass
 assertThat(42).isPositive();
 assertThat(3.142).isPositive();

 // assertions will fail
 assertThat(0).isPositive();
 assertThat(-42).isPositive();
```
    Specified by:
    
    isPositive in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Returns:
    this assertion object.
  - isNegative
```
public S isNegative()
```
    Verifies that the actual value is negative.
    Example:
```
 // assertions will pass
 assertThat(-42).isNegative();
 assertThat(-3.124).isNegative();

 // assertions will fail
 assertThat(0).isNegative();
 assertThat(42).isNegative();
```
    Specified by:
    
    isNegative in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Returns:
    this assertion object.
  - isNotNegative
```
public S isNotNegative()
```
    Verifies that the actual value is non negative (positive or equal zero).
    Example:
```
 // assertions will pass
 assertThat(42).isNotNegative();
 assertThat(0).isNotNegative();

 // assertions will fail
 assertThat(-42).isNotNegative();
 assertThat(-3.124).isNotNegative();
```
    Specified by:
    
    isNotNegative in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Returns:
    this assertion object.
  - isNotPositive
```
public S isNotPositive()
```
    Verifies that the actual value is non positive (negative or equal zero).
    Example:
```
 // assertions will pass
 assertThat(-42).isNotPositive();
 assertThat(0).isNotPositive();

 // assertions will fail
 assertThat(42).isNotPositive();
 assertThat(3.124).isNotPositive();
```
    Specified by:
    
    isNotPositive in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Returns:
    this assertion object.
  - isLessThan
```
public S isLessThan(long other)
```
    Verifies that the actual value is less than the given one.
    Example:
```
 // assertions will pass:
 assertThat(1L).isLessThan(2L);
 assertThat(-2L).isLessThan(-1L);
 
 // assertions will fail:
 assertThat(1L).isLessThan(0L);
 assertThat(1L).isLessThan(1L);
```
    Parameters:
    other - the given value to compare the actual value to.
    
    Returns:
    this assertion object.
    
    Throws:
    
    AssertionError - if the actual value is null.
    
    AssertionError - if the actual value is equal to or greater than the given one.
  - isLessThanOrEqualTo
```
public S isLessThanOrEqualTo(long other)
```
    Verifies that the actual value is less than or equal to the given one.
    Example:
```
 // assertions will pass:
 assertThat(1L).isLessThanOrEqualTo(2L);
 assertThat(-1L).isLessThanOrEqualTo(-2L);
 assertThat(1L).isLessThanOrEqualTo(1L);
 
 // assertions will fail:
 assertThat(1L).isLessThanOrEqualTo(2L);
 assertThat(-1L).isLessThanOrEqualTo(-2L);
```
    Parameters:
    other - the given value to compare the actual value to.
    
    Returns:
    this assertion object.
    
    Throws:
    
    AssertionError - if the actual value is null.
    
    AssertionError - if the actual value is greater than the given one.
  - isGreaterThan
```
public S isGreaterThan(long other)
```
    Verifies that the actual value is greater than the given one.
    Example:
```
 // assertions will pass:
 assertThat(1L).isGreaterThan(0L);
 assertThat(-1L).isGreaterThan(-2L);
 
 // assertions will fail:
 assertThat(1L).isGreaterThan(2L);
 assertThat(1L).isGreaterThan(1L);
```
    Parameters:
    other - the given value to compare the actual value to.
    
    Returns:
    this assertion object.
    
    Throws:
    
    AssertionError - if the actual value is null.
    
    AssertionError - if the actual value is equal to or less than the given one.
  - isGreaterThanOrEqualTo
```
public S isGreaterThanOrEqualTo(long other)
```
    Verifies that the actual value is greater than or equal to the given one.
    Example:
```
 // assertions will pass:
 assertThat(2L).isGreaterThanOrEqualTo(1L);
 assertThat(1L).isGreaterThanOrEqualTo(1L);
 
 // assertions will fail:
 assertThat(1L).isGreaterThanOrEqualTo(2L);
 assertThat(-1L).isGreaterThanOrEqualTo(1L);
```
    Parameters:
    other - the given value to compare the actual value to.
    
    Returns:
    this assertion object.
    
    Throws:
    
    AssertionError - if the actual value is null.
    
    AssertionError - if the actual value is less than the given one.
  - isBetween
```
public S isBetween(Long start,
          Long end)
```
    Verifies that the actual value is in [start, end] range (start included, end included).
    Example:
```
 // assertions succeed
 assertThat('b').isBetween('a', 'c');
 assertThat('a').isBetween('a', 'b');
 assertThat('b').isBetween('a', 'b');
 
 // assertions fail
 assertThat('a').isBetween('b', 'c');
 assertThat('c').isBetween('a', 'b');
```
    Specified by:
    
    isBetween in interface ComparableAssert<S extends AbstractLongAssert<S>,Long>
    
    Specified by:
    
    isBetween in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Overrides:
    
    isBetween in class AbstractComparableAssert<S extends AbstractLongAssert<S>,Long>
    
    Parameters:
    start - the start value (inclusive), expected not to be null.
    end - the end value (inclusive), expected not to be null.
    
    Returns:
    this assertion object.
  - isStrictlyBetween
```
public S isStrictlyBetween(Long start,
                  Long end)
```
    Verifies that the actual value is in ]start, end[ range (start excluded, end excluded).
    Example:
```
 // assertion succeeds
 assertThat('b').isStrictlyBetween('a', 'c');
 
 // assertions fail
 assertThat('d').isStrictlyBetween('a', 'c');
 assertThat('a').isStrictlyBetween('b', 'd');
 assertThat('a').isStrictlyBetween('a', 'b');
 assertThat('b').isStrictlyBetween('a', 'b');
```
    Specified by:
    
    isStrictlyBetween in interface ComparableAssert<S extends AbstractLongAssert<S>,Long>
    
    Specified by:
    
    isStrictlyBetween in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Overrides:
    
    isStrictlyBetween in class AbstractComparableAssert<S extends AbstractLongAssert<S>,Long>
    
    Parameters:
    start - the start value (exclusive), expected not to be null.
    end - the end value (exclusive), expected not to be null.
    
    Returns:
    this assertion object.
  - isCloseTo
```
public S isCloseTo(long expected,
          Offset<Long> offset)
```
    Verifies that the actual long is close to the given one within the given offset.
    If difference is equal to offset value, assertion is considered valid.
    Example:
```
 // assertions will pass:
 assertThat(5L).isCloseTo(7L, within(3L));

 // if difference is exactly equals to the offset, it's ok
 assertThat(5L).isCloseTo(7L, within(2L));

 // assertion will fail
 assertThat(5L).isCloseTo(7L, within(1L));
```
    Parameters:
    expected - the given long to compare the actual value to.
    offset - the given positive offset.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    AssertionError - if the actual value is not close to the given one.
  - isNotCloseTo
```
public S isNotCloseTo(long expected,
             Offset<Long> offset)
```
    Verifies that the actual long is not close to the given one by less than the given offset.
    If the difference is equal to the offset value, the assertion fails.
    Example:
```
 // assertion will pass:
 assertThat(5L).isNotCloseTo(7L, byLessThan(1L));

 // assertions will fail
 assertThat(5L).isNotCloseTo(7L, byLessThan(2L));
 assertThat(5L).isNotCloseTo(7L, byLessThan(3L));
```
    Parameters:
    expected - the given long to compare the actual value to.
    offset - the given positive offset.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    AssertionError - if the actual value is close to the given one.
    Since:
    
    2.6.0 / 3.6.0
    
    See Also:
    Assertions.byLessThan(Long)
  - isCloseTo
```
public S isCloseTo(Long expected,
          Offset<Long> offset)
```
    Verifies that the actual long is close to the given one within the given offset.
    If difference is equal to offset value, assertion is considered valid.
    Example:
```
 // assertions will pass:
 assertThat(5L).isCloseTo(Long.valueOf(7L), within(3L));

 // if difference is exactly equals to the offset, it's ok
 assertThat(5L).isCloseTo(Long.valueOf(7L), within(2L));

 // assertion will fail
 assertThat(5L).isCloseTo(Long.valueOf(7L), within(1L));
```
    Specified by:
    
    isCloseTo in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Parameters:
    expected - the given long to compare the actual value to.
    offset - the given positive offset.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    AssertionError - if the actual value is not close to the given one.
  - isNotCloseTo
```
public S isNotCloseTo(Long expected,
             Offset<Long> offset)
```
    Verifies that the actual long is not close to the given one by less than the given offset.
    If the difference is equal to the offset value, the assertion fails.
    Example:
```
 // assertion will pass:
 assertThat(5L).isNotCloseTo(Long.valueOf(7L), byLessThan(1L));

 // assertions will fail
 assertThat(5L).isNotCloseTo(Long.valueOf(7L), byLessThan(2L));
 assertThat(5L).isNotCloseTo(Long.valueOf(7L), byLessThan(3L));
```
    Specified by:
    
    isNotCloseTo in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Parameters:
    expected - the given long to compare the actual value to.
    offset - the given positive offset.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    AssertionError - if the actual value is close to the given one.
    Since:
    
    2.6.0 / 3.6.0
    
    See Also:
    Assertions.byLessThan(Long)
  - isCloseTo
```
public S isCloseTo(Long expected,
          Percentage percentage)
```
    Verifies that the actual number is close to the given one within the given percentage.
    If difference is equal to the percentage value, assertion is considered valid.
    Example with long:
```
 // assertions will pass:
 assertThat(11L).isCloseTo(Long.valueOf(10L), withinPercentage(20L));

 // if difference is exactly equals to the computed offset (1L), it's ok
 assertThat(11L).isCloseTo(Long.valueOf(10L), withinPercentage(10L));

 // assertion will fail
 assertThat(11L).isCloseTo(Long.valueOf(10L), withinPercentage(5L));
```
    Specified by:
    
    isCloseTo in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Parameters:
    expected - the given number to compare the actual value to.
    percentage - the given positive percentage.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    NullPointerException - if the expected number is null.
    
    AssertionError - if the actual value is not close to the given one.
  - isNotCloseTo
```
public S isNotCloseTo(Long expected,
             Percentage percentage)
```
    Verifies that the actual number is not close to the given one within the given percentage.
    If difference is equal to the percentage value, the assertion fails.
    Example with long:
```
 // assertion will pass:
 assertThat(11L).isNotCloseTo(Long.valueOf(10L), withinPercentage(5L));

 // assertions will fail
 assertThat(11L).isNotCloseTo(Long.valueOf(10L), withinPercentage(10L));
 assertThat(11L).isNotCloseTo(Long.valueOf(10L), withinPercentage(20L));
```
    Specified by:
    
    isNotCloseTo in interface NumberAssert<S extends AbstractLongAssert<S>,Long>
    
    Parameters:
    expected - the given number to compare the actual value to.
    percentage - the given positive percentage.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    NullPointerException - if the expected number is null.
    
    AssertionError - if the actual value is close to the given one.
    Since:
    
    2.6.0 / 3.6.0
  - isCloseTo
```
public S isCloseTo(long expected,
          Percentage percentage)
```
    Verifies that the actual number is close to the given one within the given percentage.
    If difference is equal to the percentage value, assertion is considered valid.
    Example with long:
```
 // assertions will pass:
 assertThat(11L).isCloseTo(10L, withinPercentage(20L));

 // if difference is exactly equals to the computed offset (1L), it's ok
 assertThat(11L).isCloseTo(10L, withinPercentage(10L));

 // assertion will fail
 assertThat(11L).isCloseTo(10L, withinPercentage(5L));
```
    Parameters:
    expected - the given number to compare the actual value to.
    percentage - the given positive percentage.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    NullPointerException - if the expected number is null.
    
    AssertionError - if the actual value is not close to the given one.
  - isNotCloseTo
```
public S isNotCloseTo(long expected,
             Percentage percentage)
```
    Verifies that the actual number is not close to the given one within the given percentage.
    If difference is equal to the percentage value, the assertion fails.
    Example with long:
```
 // assertion will pass:
 assertThat(11L).isNotCloseTo(10L, withinPercentage(5L));

 // assertions will fail
 assertThat(11L).isNotCloseTo(10L, withinPercentage(10L));
 assertThat(11L).isNotCloseTo(10L, withinPercentage(20L));
```
    Parameters:
    expected - the given number to compare the actual value to.
    percentage - the given positive percentage.
    
    Returns:
    this assertion object.
    
    Throws:
    
    NullPointerException - if the given offset is null.
    
    NullPointerException - if the expected number is null.
    
    AssertionError - if the actual value is close to the given one.
    Since:
    
    2.6.0 / 3.6.0
  - usingComparator
```
public S usingComparator(Comparator<? super Long> customComparator)
```
    Description copied from class: AbstractAssert
    Use given custom comparator instead of relying on actual type A equals method 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 :
```
 // frodo and sam are instances of Character with Hobbit race (obviously :).
 // raceComparator implements Comparator<Character> 
 assertThat(frodo).usingComparator(raceComparator).isEqualTo(sam);
```
    Specified by:
    
    usingComparator in interface Assert<S extends AbstractLongAssert<S>,Long>
    
    Overrides:
    
    usingComparator in class AbstractComparableAssert<S extends AbstractLongAssert<S>,Long>
    
    Parameters:
    customComparator - the comparator to use for incoming assertion checks.
    
    Returns:
    this assertion object.
  - usingDefaultComparator
```
public S usingDefaultComparator()
```
    Description copied from class: AbstractAssert
    
    Revert to standard comparison for incoming assertion checks.
    This method should be used to disable a custom comparison strategy set by calling Assert.usingComparator(Comparator).
    
    Specified by:
    
    usingDefaultComparator in interface Assert<S extends AbstractLongAssert<S>,Long>
    
    Overrides:
    
    usingDefaultComparator in class AbstractComparableAssert<S extends AbstractLongAssert<S>,Long>
    
    Returns:
    this assertion object.

Class AbstractLongAssert<S extends AbstractLongAssert<S>>

Field Summary

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

Constructor Summary

Method Summary

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

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

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

Methods inherited from class java.lang.Object

Constructor Detail

AbstractLongAssert

Method Detail

isEqualTo

isNotEqualTo

isZero

isNotZero

isPositive

isNegative

isNotNegative

isNotPositive

isLessThan

isLessThanOrEqualTo

isGreaterThan

isGreaterThanOrEqualTo

isBetween

isStrictlyBetween

isCloseTo

isNotCloseTo

isCloseTo

isNotCloseTo

isCloseTo

isNotCloseTo

isCloseTo

isNotCloseTo

usingComparator

usingDefaultComparator