public abstract Class AbstractLongAssert<SELF extends AbstractLongAssert<SELF>>

Overrides org.assertj.core.api.AbstractComparableAssert.isBetween.

Implements org.assertj.core.api.NumberAssert.isBetween, org.assertj.core.api.ComparableAssert.isBetween.

Verifies that the actual value is in [start, end] range (start included, end included).

Example:

 // assertions will pass
assertThat(1L).isBetween(-1L, 2L);
assertThat(1L).isBetween(1L, 2L);
assertThat(1L).isBetween(0L, 1L);

// assertion will fail
assertThat(1L).isBetween(2L, 3L);

Parameters

start:Long

Doc from org.assertj.core.api.NumberAssert.isBetween.

the start value (inclusive), expected not to be null.

end:Long

Doc from org.assertj.core.api.NumberAssert.isBetween.

the end value (inclusive), expected not to be null.

Returns:SELF

Doc from org.assertj.core.api.NumberAssert.isBetween.

this assertion object.

Annotations

@Override

Implements org.assertj.core.api.NumberAssert.isCloseTo.

Verifies that the actual number is close to the given one within the given offset value.

When abs(actual - expected) == offset value, the assertion:

• succeeds when using Assertions#within(Long) or Offset#offset(Number)
• fails when using Assertions#byLessThan(Long) or Offset#strictOffset(Number)

Breaking change since 2.9.0/3.9.0: using Assertions#byLessThan(Long) implies a strict comparison, use Assertions#within(Long) to get the old behavior.

Examples:

 // assertions succeed:
assertThat(5l).isCloseTo(7l, within(3l));
assertThat(5l).isCloseTo(7l, byLessThan(3l));

// if difference is exactly equals to the offset, it's ok ...
assertThat(5l).isCloseTo(7l, within(2l));
// ... but not with byLessThan which implies a strict comparison
assertThat(5l).isCloseTo(7l, byLessThan(2l)); // FAIL

// assertions fail
assertThat(5l).isCloseTo(7l, within(1l));
assertThat(5l).isCloseTo(7l, byLessThan(1l));
assertThat(5l).isCloseTo(7l, byLessThan(2l));

Parameters

expected:long

the given int to compare the actual value to.

offset:Offset<Long>

the given positive offset.

Returns:SELF

this assertion object.

Exceptions

NullPointerException:

if the given offset is null.

AssertionError:

if the actual value is not close enough to the given one.

Implements org.assertj.core.api.NumberAssert.isCloseTo.

Verifies that the actual number is close to the given one within the given offset value.

When abs(actual - expected) == offset value, the assertion:

• succeeds when using Assertions#within(Long) or Offset#offset(Number)
• fails when using Assertions#byLessThan(Long) or Offset#strictOffset(Number)

Breaking change since 2.9.0/3.9.0: using Assertions#byLessThan(Long) implies a strict comparison, use Assertions#within(Long) to get the old behavior.

Examples:

 // assertions succeed:
assertThat(5L).isCloseTo(7L, within(3L));
assertThat(5L).isCloseTo(7L, byLessThan(3L));

// if difference is exactly equals to the offset, it's ok ...
assertThat(5L).isCloseTo(7L, within(2L));
// ... but not with byLessThan which implies a strict comparison
assertThat(5L).isCloseTo(7L, byLessThan(2L)); // FAIL

// assertions fail
assertThat(5L).isCloseTo(7L, within(1L));
assertThat(5L).isCloseTo(7L, byLessThan(1L));
assertThat(5L).isCloseTo(7L, byLessThan(2L));

Parameters

expected:Long

the given int to compare the actual value to.

offset:Offset<Long>

the given positive offset.

Returns:SELF

this assertion object.

Annotations

@Override

Exceptions

NullPointerException:

if the given offset is null.

AssertionError:

if the actual value is not close enough to the given one.

Implements org.assertj.core.api.NumberAssert.isCloseTo.

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));

Parameters

expected:Long

the given number to compare the actual value to.

percentage:Percentage

the given positive percentage.

Returns:SELF

this assertion object.

Annotations

@Override

Exceptions

NullPointerException:

• if the given offset is null.
• if the expected number is null.

AssertionError:

if the actual value is not close to the given one.

Implements org.assertj.core.api.NumberAssert.isCloseTo.

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:long

the given number to compare the actual value to.

percentage:Percentage

the given positive percentage.

Returns:SELF

this assertion object.

Exceptions

NullPointerException:

• if the given offset is null.
• if the expected number is null.

AssertionError:

if the actual value is not close to the given one.

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:long

the given value to compare the actual value to.

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is not equal to the given one.

Verifies that the actual value is even.

Example:

 // assertions will pass
assertThat(12L).isEven();
assertThat(-46L).isEven();

// assertions will fail
assertThat(3L).isEven();
assertThat(15L).isEven();

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is not even.

Since

3.17.0

Overrides org.assertj.core.api.AbstractComparableAssert.isGreaterThan.

Implements org.assertj.core.api.ComparableAssert.isGreaterThan.

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:long

the given value to compare the actual value to.

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is equal to or less than the given one.

Overrides org.assertj.core.api.AbstractComparableAssert.isGreaterThanOrEqualTo.

Implements org.assertj.core.api.ComparableAssert.isGreaterThanOrEqualTo.

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:long

the given value to compare the actual value to.

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is less than the given one.

Overrides org.assertj.core.api.AbstractComparableAssert.isLessThan.

Implements org.assertj.core.api.ComparableAssert.isLessThan.

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:long

the given value to compare the actual value to.

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is equal to or greater than the given one.

Overrides org.assertj.core.api.AbstractComparableAssert.isLessThanOrEqualTo.

Implements org.assertj.core.api.ComparableAssert.isLessThanOrEqualTo.

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:long

the given value to compare the actual value to.

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is greater than the given one.

Implements org.assertj.core.api.NumberAssert.isNegative.

Doc from org.assertj.core.api.NumberAssert.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();

Returns:SELF

this assertion object.

Annotations

@Override

Implements org.assertj.core.api.NumberAssert.isNotCloseTo.

Verifies that the actual number is not close to the given one by less than the given offset.

When abs(actual - expected) == offset value, the assertion:

• succeeds when using Assertions#byLessThan(Long) or Offset#strictOffset(Number)
• fails when using Assertions#within(Long) or Offset#offset(Number)

Breaking change since 2.9.0/3.9.0: using Assertions#byLessThan(Long) implies a strict comparison, use Assertions#within(Long) to get the old behavior.

Examples:

 // assertions will pass:
assertThat(5l).isNotCloseTo(7l, byLessThan(1l));
assertThat(5l).isNotCloseTo(7l, within(1l));
// diff == offset but isNotCloseTo succeeds as we use byLessThan
assertThat(5l).isNotCloseTo(7l, byLessThan(2l));

// assertions will fail
assertThat(5l).isNotCloseTo(7l, within(2l));
assertThat(5l).isNotCloseTo(7l, byLessThan(3l));

Parameters

expected:long

the given int to compare the actual value to.

offset:Offset<Long>

the given positive offset.

Returns:SELF

this assertion object.

Exceptions

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)

Implements org.assertj.core.api.NumberAssert.isNotCloseTo.

Verifies that the actual number is not close to the given one by less than the given offset.

When abs(actual - expected) == offset value, the assertion:

• succeeds when using Assertions#byLessThan(Long) or Offset#strictOffset(Number)
• fails when using Assertions#within(Long) or Offset#offset(Number)

Breaking change since 2.9.0/3.9.0: using Assertions#byLessThan(Long) implies a strict comparison, use Assertions#within(Long) to get the old behavior.

Examples:

 // assertions will pass:
assertThat(5L).isNotCloseTo(7L, byLessThan(1L));
assertThat(5L).isNotCloseTo(7L, within(1L));
// diff == offset but isNotCloseTo succeeds as we use byLessThan
assertThat(5L).isNotCloseTo(7L, byLessThan(2L));

// assertions will fail
assertThat(5L).isNotCloseTo(7L, within(2L));
assertThat(5L).isNotCloseTo(7L, byLessThan(3L));

Parameters

expected:Long

the given int to compare the actual value to.

offset:Offset<Long>

the given positive offset.

Returns:SELF

this assertion object.

Annotations

@Override

Exceptions

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)

Implements org.assertj.core.api.NumberAssert.isNotCloseTo.

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));

Parameters

expected:Long

the given number to compare the actual value to.

percentage:Percentage

the given positive percentage.

Returns:SELF

this assertion object.

Annotations

@Override

Exceptions

NullPointerException:

• if the given offset is null.
• if the expected number is null.

AssertionError:

if the actual value is close to the given one.

Since

2.6.0 / 3.6.0

Implements org.assertj.core.api.NumberAssert.isNotCloseTo.

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:long

the given number to compare the actual value to.

percentage:Percentage

the given positive percentage.

Returns:SELF

this assertion object.

Exceptions

NullPointerException:

• if the given offset is null.
• if the expected number is null.

AssertionError:

if the actual value is close to the given one.

Since

2.6.0 / 3.6.0

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:long

the given value to compare the actual value to.

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is equal to the given one.

Implements org.assertj.core.api.NumberAssert.isNotNegative.

Doc from org.assertj.core.api.NumberAssert.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();

Returns:SELF

this assertion object.

Annotations

@Override

Implements org.assertj.core.api.NumberAssert.isNotPositive.

Doc from org.assertj.core.api.NumberAssert.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();

Returns:SELF

this assertion object.

Annotations

@Override

Implements org.assertj.core.api.NumberAssert.isNotZero.

Doc from org.assertj.core.api.NumberAssert.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();

Returns:SELF

this assertion object.

Annotations

@Override

Verifies that the actual value is odd.

Example:

 // assertions will pass
assertThat(3L).isOdd();
assertThat(-17L).isOdd();

// assertions will fail
assertThat(2L).isOdd();
assertThat(-24L).isOdd();

Returns:SELF

this assertion object.

Exceptions

AssertionError:

• if the actual value is null.
• if the actual value is not odd.

Since

3.17.0

Implements org.assertj.core.api.NumberAssert.isOne.

Doc from org.assertj.core.api.NumberAssert.isOne.

Verifies that the actual value is equal to one.

Example:

 // assertions will pass
assertThat(1).isOne();
assertThat(1.0).isOne();

// assertions will fail
assertThat(42).isOne();
assertThat(3.142).isOne();

Returns:SELF

this assertion object.

Annotations

@Override

Implements org.assertj.core.api.NumberAssert.isPositive.

Doc from org.assertj.core.api.NumberAssert.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();

Returns:SELF

this assertion object.

Annotations

@Override

Overrides org.assertj.core.api.AbstractComparableAssert.isStrictlyBetween.

Implements org.assertj.core.api.NumberAssert.isStrictlyBetween, org.assertj.core.api.ComparableAssert.isStrictlyBetween.

Verifies that the actual value is in ]start, end[ range (start excluded, end excluded).

Example:

 // assertion will pass
assertThat(1L).isStrictlyBetween(-1L, 2L);

// assertions will fail
assertThat(1L).isStrictlyBetween(1L, 2L);
assertThat(1L).isStrictlyBetween(0L, 1L);
assertThat(1L).isStrictlyBetween(2L, 3L);

Parameters

start:Long

Doc from org.assertj.core.api.NumberAssert.isStrictlyBetween.

the start value (exclusive), expected not to be null.

end:Long

Doc from org.assertj.core.api.NumberAssert.isStrictlyBetween.

the end value (exclusive), expected not to be null.

Returns:SELF

Doc from org.assertj.core.api.NumberAssert.isStrictlyBetween.

this assertion object.

Annotations

@Override

Implements org.assertj.core.api.NumberAssert.isZero.

Doc from org.assertj.core.api.NumberAssert.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();

Returns:SELF

this assertion object.

Annotations

@Override

Overrides org.assertj.core.api.AbstractComparableAssert.usingComparator.

Implements org.assertj.core.api.Assert.usingComparator.

Doc from org.assertj.core.api.AbstractAssert.usingComparator.

Use the given custom comparator instead of relying on actual type A equals method for incoming assertion checks.

The custom comparator is bound to assertion instance, meaning that if a new assertion instance is created, the default comparison strategy will be used.

Examples :

 // frodo and sam are instances of Character with Hobbit race (obviously :).
// raceComparator implements Comparator<Character>
assertThat(frodo).usingComparator(raceComparator).isEqualTo(sam);

Parameters

customComparator:Comparator<? super Long>

Doc from org.assertj.core.api.Assert.usingComparator.

the comparator to use for the incoming assertion checks.

Returns:SELF

Doc from org.assertj.core.api.Assert.usingComparator.

this assertion object.

Annotations

@Override

@CheckReturnValue

Overrides org.assertj.core.api.AbstractComparableAssert.usingComparator.

Implements org.assertj.core.api.Assert.usingComparator.

Doc from org.assertj.core.api.AbstractAssert.usingComparator.

Use the given custom comparator instead of relying on actual type A equals method for incoming assertion checks.

The custom comparator is bound to assertion instance, meaning that if a new assertion instance is created, the default comparison strategy will be used.

Examples :

 // frodo and sam are instances of Character with Hobbit race (obviously :).
// raceComparator implements Comparator<Character>
assertThat(frodo).usingComparator(raceComparator, "Hobbit Race Comparator").isEqualTo(sam);

Parameters

customComparator:Comparator<? super Long>

Doc from org.assertj.core.api.Assert.usingComparator.

the comparator to use for the incoming assertion checks.

customComparatorDescription:String

Doc from org.assertj.core.api.Assert.usingComparator.

comparator description to be used in assertion error messages

Returns:SELF

Doc from org.assertj.core.api.Assert.usingComparator.

this assertion object.

Annotations

@Override

@CheckReturnValue

Overrides org.assertj.core.api.AbstractComparableAssert.usingDefaultComparator.

Implements org.assertj.core.api.Assert.usingDefaultComparator.

Doc from org.assertj.core.api.AbstractAssert.usingDefaultComparator.

Revert to standard comparison for the incoming assertion checks.

This method should be used to disable a custom comparison strategy set by calling usingComparator.

Returns:SELF

Doc from org.assertj.core.api.Assert.usingDefaultComparator.

this assertion object.

Annotations

@Override

@CheckReturnValue