Package eu.simuline.util

Interface MultiSet.Multiplicity

All Superinterfaces:

java.lang.Comparable<MultiSet.Multiplicity>

All Known Implementing Classes:

AbstractMultiSet.MultiplicityImpl, CollectionsExt.ImmutableMultiplicity

Enclosing interface:

MultiSet<T>

public static interface MultiSet.Multiplicity
extends java.lang.Comparable<MultiSet.Multiplicity>

Represents the multiplicity of an entry of the enclosing multi-set.

Method Summary

Modifier and Type	Method	Description
int	add(int mult)	Adds the specified multiplicity (which may well be negative) to the wrapped multiplicity which is thus modified.
int	compareTo(MultiSet.Multiplicity mult)	Defines the natural ordering on natural numbers.
boolean	equals(java.lang.Object obj)
int	get()	Returns the wrapped multiplicity.
int	set(int mult)	Sets the multiplicity wrapped by this object to the specified value.

Method Detail

set

int set(int mult)

Sets the multiplicity wrapped by this object to the specified value.

Parameters:

mult - a strictly positive int value representing the old multiplicity.

Throws:

java.lang.IllegalArgumentException - if mult is not strictly positive.

java.lang.UnsupportedOperationException - if setting the multiplicity would modify this Multiplicity object in a way which is not supported.

add

int add(int mult)

Adds the specified multiplicity (which may well be negative) to the wrapped multiplicity which is thus modified.

Parameters:

mult - an int such that this.mult + mult > 0 holds.

Returns:

the new multiplicity this.mult + mult.

Throws:

java.lang.IllegalArgumentException - if this.mult + mult < 0 holds.

java.lang.IllegalStateException - if this.mult + mult == 0 holds. This cannot occur: if it does this is a bug within this class.

java.lang.UnsupportedOperationException - if setting the multiplicity would modify this Multiplicity object in a way which is not supported.

get

int get()

Returns the wrapped multiplicity.

compareTo

int compareTo(MultiSet.Multiplicity mult)

Defines the natural ordering on natural numbers.

Specified by:

compareTo in interface java.lang.Comparable<MultiSet.Multiplicity>

Parameters:

mult - a Multiplicity which should in fact be another MultiSet.Multiplicity.

Returns:

the difference of the wrapped multiplicities.

Throws:

java.lang.NullPointerException - for mult == null.

java.lang.ClassCastException - if mult is neither null nor an instance of MultiSet.Multiplicity.

equals

boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object