maspack.util

Class StringRange

java.lang.Object

maspack.util.RangeBase

maspack.util.StringRange

All Implemented Interfaces:

java.lang.Cloneable, Clonable, Range, Scannable

public class StringRange
extends RangeBase

Field Summary

Fields inherited from interface maspack.util.Range

IllegalValue

Constructor Summary

Constructors

Constructor and Description
StringRange()
StringRange(java.util.Collection<java.lang.String> valid)
StringRange(java.lang.String... valid)

Method Summary

Modifier and Type	Method and Description
StringRange	clone()
java.lang.String[]	getValidStrings()
void	intersect(Range r) Intersects the set of valid values of this Range with those of another.
boolean	isEmpty() Returns true if this range is empty - i.e., if there are no valid values.
boolean	isValid(java.lang.Object obj, StringHolder errMsg) Returns true if the specified object is valid for this Range, and false otherwise.
boolean	isWildcard()
static void	main(java.lang.String[] args)
java.lang.Object	makeValid(java.lang.Object obj) Projects an object to lie within the range allowed by this Range, if possible.
void	scan(ReaderTokenizer rtok, java.lang.Object ref) Scans this element from a ReaderTokenizer.
java.lang.String	toString()
void	write(java.io.PrintWriter pw, NumberFormat fmt, java.lang.Object ref) Writes a text description of this element to a PrintWriter.

Methods inherited from class maspack.util.RangeBase

isWritable, setError

Methods inherited from class java.lang.Object

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

Constructor Detail

StringRange

public StringRange()

StringRange

public StringRange(java.util.Collection<java.lang.String> valid)

StringRange

public StringRange(java.lang.String... valid)

Method Detail

getValidStrings

public java.lang.String[] getValidStrings()

isWildcard

public boolean isWildcard()

isValid

public boolean isValid(java.lang.Object obj,
                       StringHolder errMsg)

Description copied from class: RangeBase

Returns true if the specified object is valid for this Range, and false otherwise. If the object is not valid, and errMsg is not null, then errMsg.value should be set to a message describing why the object is not valid.

Specified by:

isValid in interface Range

Specified by:

isValid in class RangeBase

Parameters:

obj - Object to be testes

errMsg - Optional handle for storing error message

Returns:

true if the object is valid

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

makeValid

public java.lang.Object makeValid(java.lang.Object obj)

Description copied from class: RangeBase

Projects an object to lie within the range allowed by this Range, if possible. If obj is already within the range, then obj should be returned unchanged. Otherwise, if it can be projected to the range, then a new (projected) object should be returned. Otherwise, if it cannot be projected, Range.IllegalValue should be returned.

In particular, projectToRange(obj) != obj should be a valid indication that the obj is not within range.

Specified by:

makeValid in interface Range

Overrides:

makeValid in class RangeBase

Parameters:

obj - object to be projected

Returns:

original obj if within range, or a projected object, or null.

isEmpty

public boolean isEmpty()

Description copied from class: RangeBase

Returns true if this range is empty - i.e., if there are no valid values. This will typically result from the intersection of two non-overlapping ranges.

Specified by:

isEmpty in interface Range

Overrides:

isEmpty in class RangeBase

Returns:

true if this range has no valid values.

intersect

public void intersect(Range r)

Description copied from class: RangeBase

Intersects the set of valid values of this Range with those of another. If the resulting intersection is null, then Range.isEmpty() should subsequently return true.

Specified by:

intersect in interface Range

Overrides:

intersect in class RangeBase

Parameters:

r - range to intersect with.

scan

public void scan(ReaderTokenizer rtok,
                 java.lang.Object ref)
          throws java.io.IOException

Description copied from class: RangeBase

Scans this element from a ReaderTokenizer. The expected text format is assumed to be compatible with that produced by write.

Specified by:

scan in interface Scannable

Overrides:

scan in class RangeBase

Parameters:

rtok - Tokenizer from which to scan the element

ref - optional reference object which can be used for resolving references to other objects

Throws:

java.io.IOException - if an I/O or formatting error occured

write

public void write(java.io.PrintWriter pw,
                  NumberFormat fmt,
                  java.lang.Object ref)
           throws java.io.IOException

Description copied from class: RangeBase

Writes a text description of this element to a PrintWriter. The text description should be compatable with scan and complete enough to allow full reconstruction of the element.

Specified by:

write in interface Scannable

Overrides:

write in class RangeBase

Parameters:

pw - stream for writing the element

fmt - numeric formating information

ref - optional reference object which can be used for producing references to other objects

Throws:

java.io.IOException - if an I/O error occured

clone

public StringRange clone()

Specified by:

clone in interface Clonable

Overrides:

clone in class RangeBase

main

public static void main(java.lang.String[] args)