Package net.jqwik.api

Class ShrinkingDistance

java.lang.Object

net.jqwik.api.ShrinkingDistance

All Implemented Interfaces:

Comparable<ShrinkingDistance>

@API(status=STABLE,
     since="1.0")
public class ShrinkingDistance
extends Object
implements Comparable<ShrinkingDistance>

A ShrinkingDistance is a measure of how close a value is to the minimum value, aka target value.

The distance is used during shrinking to determine if a shrunk value is really closer to the target value. If it is not, the value is being discarded.

Field Summary

Fields

Modifier and Type	Field	Description
static final ShrinkingDistance	MAX
static final ShrinkingDistance	MIN

Method Summary

Modifier and Type	Method	Description
ShrinkingDistance	append(ShrinkingDistance other)
static <T> ShrinkingDistance	combine(List<Shrinkable<T>> shrinkables)
int	compareTo(ShrinkingDistance other)	Compare to distances with each other.
List<ShrinkingDistance>	dimensions()
boolean	equals(@Nullable Object o)
static <T> ShrinkingDistance	forCollection(Collection<Shrinkable<T>> elements)
int	hashCode()
static ShrinkingDistance	of(long... distances)	Create a ShrinkingDistance with one or more dimensions.
ShrinkingDistance	plus(ShrinkingDistance other)
int	size()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

MAX

@API(status=MAINTAINED,
     since="1.2.0")
public static final ShrinkingDistance MAX

MIN

@API(status=MAINTAINED,
     since="1.7.2")
public static final ShrinkingDistance MIN

Method Details

of

@API(status=MAINTAINED,
     since="1.0")
public static ShrinkingDistance of(long... distances)

Create a ShrinkingDistance with one or more dimensions.

Parameters:

distances - a non-empty array of non-negative values.

Returns:

an immutable instance of ShrinkingDistance

forCollection

@API(status=MAINTAINED,
     since="1.0")
public static <T> ShrinkingDistance forCollection(Collection<Shrinkable<T>> elements)

combine

@API(status=MAINTAINED,
     since="1.0")
public static <T> ShrinkingDistance combine(List<Shrinkable<T>> shrinkables)

equals

public boolean equals(@Nullable
 @Nullable Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

compareTo

public int compareTo(ShrinkingDistance other)

Compare to distances with each other. No distance can be greater than MAX. No distance can be smaller than MIN.

Specified by:

compareTo in interface Comparable<ShrinkingDistance>

dimensions

@API(status=INTERNAL)
public List<ShrinkingDistance> dimensions()

size

@API(status=INTERNAL)
public int size()

plus

@API(status=INTERNAL)
public ShrinkingDistance plus(ShrinkingDistance other)

append

@API(status=INTERNAL)
public ShrinkingDistance append(ShrinkingDistance other)