|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.print.attribute.SetOfIntegerSyntax
public abstract class SetOfIntegerSyntax
SetOfIntegerSyntax
is the abstract base class of all attribute
classes which provide a set of non-negative integers as value (e.g. the
page ranges to print) represented as single values or ranges of values.
A SetOfIntegerSyntax
instance consists of an integer array of
ranges. Ranges may have the same lower and upper bound representing a single
integer value. Ranges with a lower bound greater than the upper bound are
null ranges and discarded. Ranges may overlap in their values. In no case
negative integers are allowed.
There are several constructors available:
SetOfIntegerSyntax(int member)
SetOfIntegerSyntax(int lowerBound, int upperBound)
SetOfIntegerSyntax(int[][] members)
int[0][]
for empty set of integers, int[][] {{1}}
, int[][] {{1,5}}
, int[][] {{1,5},{7,9}}
,
int[][] {{3,7},{19}}
.
SetOfIntegerSyntax(String s)
""
for an empty set of integers,
"1"
, "1-5"
, "1-5,7-9"
,
"3-7,19"
and "1:2,4"
.
Internal storage:
The set of integers are stored internally in a normalized array form.
In the normalized array form the set of integer ranges are represented
in as few ranges as possible and overlapping ranges are merged. The ranges
are always represented as an integer array of length two with ranges
stored in {lower bound, upper bound} form. The ranges are stored in
ascending order, without any null ranges.
Constructor Summary | |
---|---|
protected |
SetOfIntegerSyntax(int member)
Creates a SetOfIntegerSyntax object. |
protected |
SetOfIntegerSyntax(int[][] members)
Creates a SetOfIntegerSyntax object. |
protected |
SetOfIntegerSyntax(int lowerBound,
int upperBound)
Creates a SetOfIntegerSyntax object. |
protected |
SetOfIntegerSyntax(String s)
Creates a SetOfIntegerSyntax object. |
Method Summary | |
---|---|
boolean |
contains(int value)
Checks if this set contains the given value. |
boolean |
contains(IntegerSyntax value)
Checks if this set contains the given value. |
boolean |
equals(Object obj)
Tests if the given object is equal to this object. |
int[][] |
getMembers()
Returns an array describing the members included in this set. |
int |
hashCode()
Returns the hashcode for this object. |
int |
next(int x)
Returns the smallest value that is greater than x which is in this set. |
String |
toString()
Returns the string representation for this object. |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
protected SetOfIntegerSyntax(int member)
SetOfIntegerSyntax
object.
member
- the member value
IllegalArgumentException
- if member is < 0protected SetOfIntegerSyntax(int[][] members)
SetOfIntegerSyntax
object.
members
- the members to use in this set. If
null
an empty set is created.
IllegalArgumentException
- if any element is invalid
NullPointerException
- if any element of members is nullprotected SetOfIntegerSyntax(String s)
SetOfIntegerSyntax
object.
s
- the members to use in this set in string form. If
null
an empty set is created.
IllegalArgumentException
- if any element is invalidprotected SetOfIntegerSyntax(int lowerBound, int upperBound)
SetOfIntegerSyntax
object.
lowerBound
- the lower bound valueupperBound
- the upper bound value
IllegalArgumentException
- if lowerBound <= upperbound
and lowerBound < 0Method Detail |
---|
public boolean contains(int value)
value
- the value to test for
public boolean contains(IntegerSyntax value)
value
- the value to test for
public boolean equals(Object obj)
equals
in class Object
obj
- the object to test
Object.hashCode()
public int[][] getMembers()
public int hashCode()
hashCode
in class Object
Object.equals(Object)
,
System.identityHashCode(Object)
public int next(int x)
x
- an integer value
-1
if there
is no greater integer in the set.public String toString()
"1-2,5-7,10"
.
toString
in class Object
Object.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |