gov.nasa.jpf.vm.choice

Class NumberChoiceFromList<T extends Number>

java.lang.Object

gov.nasa.jpf.vm.ChoiceGeneratorBase<T>

gov.nasa.jpf.vm.choice.NumberChoiceFromList<T>

All Implemented Interfaces:

ChoiceGenerator<T>, Cloneable

Direct Known Subclasses:

DoubleChoiceFromList, FloatChoiceFromList, IntChoiceFromList, LongChoiceFromList

public abstract class NumberChoiceFromList<T extends Number>
extends ChoiceGeneratorBase<T>

common root for list based number choice generators

Field Summary

Fields

Modifier and Type	Field and Description
protected int	count
protected T[]	values

Fields inherited from class gov.nasa.jpf.vm.ChoiceGeneratorBase

attr, id, idRef, insn, isCascaded, isDone, MARKER, prev, random, ti

Constructor Summary

Constructors

Modifier	Constructor and Description
	NumberChoiceFromList(Config conf, String id)
protected	NumberChoiceFromList(String id) super constructor for subclasses that want to configure themselves
protected	NumberChoiceFromList(String id, T[] vals)

Method Summary

Methods

Modifier and Type	Method and Description
void	advance() advance to the next choice.
protected abstract T[]	createValueArray(int len)
protected abstract T	getDefaultValue()
T	getNextChoice()
int	getProcessedNumberOfChoices()
int	getTotalNumberOfChoices()
String	getValueLabel() get String label of current value, as specified in config file
boolean	hasMoreChoices()
protected abstract T	newValue(Number num, int sign)
protected T	parse(String varSpec, StackFrame resolveFrame)
protected abstract T	parseLiteral(String literal, int sign)
NumberChoiceFromList<T>	randomize() turn the order of choices random (if it isn't already).
NumberChoiceFromList<T>	reorder(Comparator<T> comparator) reorder according to a user provided comparator
void	reset() this has to reset the CG to its initial state, which includes resetting 'isDone'
boolean	supportsReordering()
String	toString()

Methods inherited from class gov.nasa.jpf.vm.ChoiceGeneratorBase

addAttr, advance, attrIterator, attrIterator, clone, deepClone, getAll, getAllOfType, getAttr, getAttr, getCascade, getCascadedParent, getId, getIdRef, getInsn, getNextAttr, getPreviousChoiceGenerator, getPreviousChoiceGeneratorOfType, getSourceLocation, getThreadInfo, hasAttr, hasAttr, hasAttrValue, init, isCascaded, isDone, isProcessed, isSchedulingPoint, removeAttr, replaceAttr, select, setAttr, setCascaded, setContext, setDone, setId, setIdRef, setInsn, setPreviousChoiceGenerator, setThreadInfo, useRandomization

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface gov.nasa.jpf.vm.ChoiceGenerator

getChoiceType

Field Detail

values

protected T extends Number[] values

count

protected int count

Constructor Detail

NumberChoiceFromList

protected NumberChoiceFromList(String id)

super constructor for subclasses that want to configure themselves

Parameters:

id - name used in choice config

NumberChoiceFromList

protected NumberChoiceFromList(String id,
                    T[] vals)

NumberChoiceFromList

public NumberChoiceFromList(Config conf,
                    String id)

Parameters:

conf - JPF configuration object

id - name used in choice config

Method Detail

createValueArray

protected abstract T[] createValueArray(int len)

getDefaultValue

protected abstract T getDefaultValue()

parseLiteral

protected abstract T parseLiteral(String literal,
             int sign)

newValue

protected abstract T newValue(Number num,
         int sign)

reset

public void reset()

Description copied from interface: ChoiceGenerator

this has to reset the CG to its initial state, which includes resetting 'isDone'

getNextChoice

public T getNextChoice()

See Also:

ChoiceGenerator.getNextChoice()

hasMoreChoices

public boolean hasMoreChoices()

See Also:

ChoiceGenerator.hasMoreChoices()

advance

public void advance()

Description copied from interface: ChoiceGenerator

advance to the next choice. This is the only method that really advances our enumeration

See Also:

ChoiceGenerator.advance()

getValueLabel

public String getValueLabel()

get String label of current value, as specified in config file

getTotalNumberOfChoices

public int getTotalNumberOfChoices()

getProcessedNumberOfChoices

public int getProcessedNumberOfChoices()

supportsReordering

public boolean supportsReordering()

Specified by:

supportsReordering in interface ChoiceGenerator<T extends Number>

Overrides:

supportsReordering in class ChoiceGeneratorBase<T extends Number>

parse

protected T parse(String varSpec,
      StackFrame resolveFrame)

reorder

public NumberChoiceFromList<T> reorder(Comparator<T> comparator)

Description copied from class: ChoiceGeneratorBase

reorder according to a user provided comparator

Specified by:

reorder in interface ChoiceGenerator<T extends Number>

Overrides:

reorder in class ChoiceGeneratorBase<T extends Number>

toString

public String toString()

Overrides:

toString in class ChoiceGeneratorBase<T extends Number>

randomize

public NumberChoiceFromList<T> randomize()

Description copied from interface: ChoiceGenerator

turn the order of choices random (if it isn't already). Only drawback of this generic method (which might be a decorator factory) is that our type layer (e.g. IntChoiceGenerator) has to guarantee type safety. But hey - this is the first case where we can use covariant return types! NOTES: - this method may alter this ChoiceGenerator and return that or return a new "decorated" version. - random data can be read from the "Random random" field in this class.

Specified by:

randomize in interface ChoiceGenerator<T extends Number>

Overrides:

randomize in class ChoiceGeneratorBase<T extends Number>