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 可以進行以下操作：以規範陣列形式返回集合的成員、測試給定的整數是否為集合的成員，迭代集合的成員。

另請參見：

序列化表格

建構子摘要

protected	SetOfIntegerSyntax(int member) 建構一個套件含單個整數的新整數集屬性。
protected	SetOfIntegerSyntax(int[][] members) 使用以字元串形式給定的成員建構一個新的整數集屬性。
protected	SetOfIntegerSyntax(int lowerBound, int upperBound) 建構一個套件含單一整數範圍的新整數集屬性。
protected	SetOfIntegerSyntax(String members) 使用以字元串形式給定的成員建構一個新的整數集屬性。

方法摘要

boolean	contains(int x) 確定此整數集屬性是否包含給定的值。
boolean	contains(IntegerSyntax attribute) 確定此整數集屬性是否包含給定的整數屬性的值。
boolean	equals(Object object) 返回此整數集屬性是否等效於傳入的物件。
int[][]	getMembers() 獲取規範陣列形式的此整數集屬性的成員。
int	hashCode() 返回此整數集屬性的雜湊碼值。
int	next(int x) 確定此整數集屬性中的最小整數是否大於給定值。
String	toString() 返回對應於此整數集屬性的字元串值。

從類別 java.lang.Object 繼承的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

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。

equals

public boolean equals(Object object)

返回此整數集屬性是否等效於傳入的物件。若要等效，以下所有條件都必須為 true：

1. object 不為 null。
2. object 是類別 SetOfIntegerSyntax 的一個實例。
3. 此整數集屬性的成員和 object 的成員相同。

覆寫：

類別 Object 中的 equals

參數：

object - 要比較的物件。

返回：

如果 object 等效於此整數集屬性，則返回 True，否則返回 false。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此整數集屬性的雜湊碼值。雜湊碼是規範陣列形式的範圍的上邊界和下邊界的總數，0 表示空集。

覆寫：

類別 Object 中的 hashCode

返回：

此物件的一個雜湊碼值。

另請參見：

Object.equals(java.lang.Object), Hashtable

toString

public String toString()

返回對應於此整數集屬性的字元串值。如果此集合為空，則字元串值為零長度字元串。否則，字元串值是規範陣列形式的範圍的逗號分隔的列表，其中，如果下邊界等於上邊界，則可以將每個範圍表示為 "i"，否則表示為 "i-j"。

覆寫：

類別 Object 中的 toString

返回：

該物件的字元串表示形式。