Java javax.print.attribute 类 SetOfIntegerSyntax（JDK5）

所有类

javax.print.attribute
类 SetOfIntegerSyntax

java.lang.Object
  javax.print.attribute.SetOfIntegerSyntax

所有已实现的接口：

Serializable, Cloneable

直接已知子类：

CopiesSupported, JobImpressionsSupported, JobKOctetsSupported, JobMediaSheetsSupported, NumberUpSupported, PageRanges

public abstract class SetOfIntegerSyntax
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Serializable, Cloneable
   
   
   
   
   

类 SetOfIntegerSyntax 是一种抽象的基类，它提供其值是非负整数集合的所有属性的公共实现。这包括其值是一个整数范围的属性和其值是一组整数范围的属性。

可以用“字符串形式”构造一个 SetOfIntegerSyntax 的实例。字符串由零或多个用逗号分隔的整数组组成。每个整数组由一个整数、连字符 (-) 分隔的两个整数，或冒号 (:) 分隔的两个整数组成。每个整数由一个或多个十进制数字（0 至 9）组成。空格字符不能在整数中显示，否则被忽略。例如： "", "1", "5-10", "1:2, 4".

也可以使用“数组形式”构造一个 SetOfIntegerSyntax 的实例。数组形式由零个或多个整数组的数组组成，其中每个整数组是长度为 1 或长度为 2 的 int 数组；例如，int[0][]、int[][]{{1}}、int[][]{{5,10}}、int[][]{{1,2},{4}}。

在字符串形式和数组形式中，每个连续的整数组都提供一系列在集合中包括的整数。每组中的第一个整数提供该范围的下边界；第二个整数提供该范围的上边界；如果在组中仅有一个整数，则上边界与下边界相同。如果上边界小于下边界，则它表示一个 null 范围（无值）。如果上边界等于下边界，则它表示由单个值组成的范围。如果上边界大于下边界，则它表示由多个值组成的范围。该范围可以按任意顺序显示，并允许重叠。所有范围的并集给出该集合的内容。一旦构造 SetOfIntegerSyntax 实例之后，其值就是不可变的。

SetOfIntegerSyntax 对象的值实际上以“规范 数组形式”存储。除没有任何 null 范围外，这与数组形式相同；用尽可能少的范围（即：合并重叠范围）表示集合的成员；范围按升序显示；并且将每个范围按形式 {下边界, 上边界} 表示为长度为 2 的 int 数组。将空集表示为零长度数组。

类 SetOfIntegerSyntax 可以进行以下操作：以规范数组形式返回集合的成员、测试给定的整数是否为集合的成员，迭代集合的成员。

另请参见：

序列化表格

SetOfIntegerSyntax

protected SetOfIntegerSyntax(String members)

使用以字符串形式给定的成员构造一个新的整数集属性。

参数：

members - 字符串形式的集合成员。如果为 null，则构造一个空集。

抛出：

IllegalArgumentException - （未经检查的异常）如果 members 不遵循正确的语法，则抛出该异常。

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int[][] members)

使用以字符串形式给定的成员构造一个新的整数集属性。

参数：

members - 数组形式的集合成员。如果为 null，则构造一个空集。

抛出：

NullPointerException - （未经检查的异常）如果 members 的任何元素为 null，则抛出该异常。

IllegalArgumentException - （未经检查的异常）如果 members 的任何元素不是长度为 1 或长度为 2 的数组，或者如果 members 中任何非 null 范围的下边界小于零，则抛出该异常。

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int member)

构造一个包含单个整数的新整数集属性。

参数：

member - 集合成员。

抛出：

IllegalArgumentException - （未经检查的异常）如果 member 小于零，则抛出该异常。

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int lowerBound,
                             int upperBound)

构造一个包含单一整数范围的新整数集属性。如果下边界大于上边界（null 范围），则构造一个空集。

参数：

lowerBound - 范围的下边界。

upperBound - 范围的上边界。

抛出：

IllegalArgumentException - （未经检查的异常）如果范围为非 null，并且 lowerBound 小于零，则抛出该异常。

getMembers

public int[][] getMembers()

获取规范数组形式的此整数集属性的成员。返回的数组是“安全的”；客户机可以在不影响此整数集属性的情况下对它进行更改。

返回：

规范数组形式的此整数集属性的成员。

contains

public boolean contains(int x)

确定此整数集属性是否包含给定的值。

参数：

x - 整数值。

返回：

如果此整数集属性包含值 x，则返回 True，否则返回 false。

contains

public boolean contains(IntegerSyntax attribute)

确定此整数集属性是否包含给定的整数属性的值。

参数：

attribute - 整数属性。

返回：

如果此整数集属性包含 theAttribute 的值，则返回 True，否则返回 false。

next

public int next(int x)

确定此整数集属性中的最小整数是否大于给定值。如果此整数集属性中没有任何整数大于给定值，则返回 -1。（由于整数集属性只包含非负值，所以该集合中始终不显示 -1。）可以使用 next() 方法按升序迭代整数集属性中的整数值，如下所示：

     SetOfIntegerSyntax attribute = . . .;
     int i = -1;
     while ((i = attribute.next (i)) != -1)
         {
         foo (i);
         }
 

参数：

x - 整数值。

返回：

此整数集属性中大于 x 的最小整数，如果此整数集属性中没有任何整数大于 x，则返回 -1。