- 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またはそれ以上のカンマで区切られた整数型のグループから構成されます。 各整数型のグループは、1つの整数型、ハイフン(-)で区切られた2つの整数型、またはコロン(:)で区切られた2つの整数型のどれかから構成されます。 各整数型は、1つ以上の10進数(0-9)から構成されます。 空白文字は整数型の内部では使用されないか、または無視されます。 たとえば:""、"1"、"5-10"、"1:2, 4"など。SetOfIntegerSyntaxのインスタンスを配列形式で指定して、インスタンスを作成することもできます。 配列形式は、0またはそれ以上の整数型のグループから構成されます。各整数型グループは、長さ1または長さ2のint配列から構成されます。たとえば、int[0][]、int[][]{{1}}、int[][]{{5,10}}、int[][]{{1,2},{4}}のようになります。文字列形式と配列形式の両方で、連続する各整数型のグループはセットに含まれる整数型の範囲を指定します。 各グループの最初の整数型は範囲の下限を指定します。各グループの2番目の整数型は範囲の上限を指定します。グループに1つの整数型しかない場合、上限は下限と同じになります。 上限が下限より小さい場合は、
nullの範囲(値なし)を示します。 上限が下限と等しい場合、単一の値から構成される範囲を示します。 上限が下限より大きい場合、複数の値から構成される範囲を示します。 範囲は任意の順番で表示され、オーバーラップできます。 すべての範囲の結合は、セットの内容を提供します。SetOfIntegerSyntaxインスタンスが作成されると、その値は不変になります。SetOfIntegerSyntaxオブジェクトの値は、実際には正規配列形式で格納されます。 これは配列形式と同じですが、nullの範囲はありません。セットのメンバーはできるだけ少ない範囲で表現されます(つまり、重複する範囲が結合されます)。範囲は昇順で表示されます。各範囲は、常にintの長さ2の配列として{lower bound、 upper bound}形式で表されます。 空のセットは、長さ0の配列として表されます。クラス
SetOfIntegerSyntaxには、正規配列形式でセットのメンバーを戻し、指定された整数がそのセットのメンバーかどうかをテストし、そのセットのメンバーを反復処理する操作があります。- 関連項目:
- 直列化された形式
-
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 protectedSetOfIntegerSyntax(int member)単一の整数型を保持する新しい整数型セットの属性を構築します。protectedSetOfIntegerSyntax(int[][] members)指定されたメンバーを持つ新しい整数型セットの属性を配列形式で構築します。protectedSetOfIntegerSyntax(int lowerBound, int upperBound)単一の整数型の範囲を保持する新しい整数型セットの属性を構築します。protectedSetOfIntegerSyntax(String members)指定されたメンバーを持つ新しい整数型セットの属性を文字列形式で構築します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 booleancontains(int x)整数型セットの属性が指定された値を保持しているかどうかを判定します。booleancontains(IntegerSyntax attribute)整数型セットの属性が指定された整数型の属性の値を保持しているかどうかを判定します。booleanequals(Object object)この整数型セットの属性がオブジェクトに渡された属性と等しいかどうかを返します。int[][]getMembers()この整数型セットの属性のメンバーを正規配列形式で取得します。inthashCode()この整数型セットの属性のハッシュ・コード値を返します。intnext(int x)整数型セットの属性の中で、指定された値より大きい最小の整数を判定します。StringtoString()この整数型セットの属性に対応する文字列値を返します。
-
-
-
コンストラクタの詳細
-
SetOfIntegerSyntax
protected SetOfIntegerSyntax(String members)
指定されたメンバーを持つ新しい整数型セットの属性を文字列形式で構築します。- パラメータ:
members- 文字列形式でメンバーを設定します。nullの場合、空のセットが作成されます。- 例外:
IllegalArgumentException-membersが適切な構文に従わない場合
-
SetOfIntegerSyntax
protected SetOfIntegerSyntax(int[][] members)
指定されたメンバーを持つ新しい整数型セットの属性を配列形式で構築します。- パラメータ:
members- 配列形式でメンバーを設定します。nullの場合、空のセットが作成されます。- 例外:
NullPointerException-membersのいずれかの要素がnullの場合IllegalArgumentException-membersのいずれかの要素がlength-1またはlength-two配列でない場合、またはmembersのnon-null範囲にゼロより小さい下限がある場合
-
SetOfIntegerSyntax
protected SetOfIntegerSyntax(int member)
単一の整数型を保持する新しい整数型セットの属性を構築します。- パラメータ:
member- メンバーの設定- 例外:
IllegalArgumentException-memberが負の場合
-
SetOfIntegerSyntax
protected SetOfIntegerSyntax(int lowerBound, int upperBound)単一の整数型の範囲を保持する新しい整数型セットの属性を構築します。 下限が上限より大きい場合(nullの範囲)、空のセットが構築されます。- パラメータ:
lowerBound- 範囲の下限upperBound- 範囲の上限- 例外:
IllegalArgumentException- 範囲がnon-nullで、lowerBoundがゼロより小さい場合
-
-
メソッドの詳細
-
getMembers
public int[][] getMembers()
この整数型セットの属性のメンバーを正規配列形式で取得します。 返される配列は「安全」です。クライアントはこの整数型セットの属性に影響を与えずに配列を変更できます。- 戻り値:
- 正規配列形式でのこの整数集合属性のメンバー
-
contains
public boolean contains(int x)
整数型セットの属性が指定された値を保持しているかどうかを判定します。- パラメータ:
x- 整数値- 戻り値:
- この整数集合属性に値
xが含まれる場合はtrue、それ以外の場合はfalse
-
contains
public boolean contains(IntegerSyntax attribute)
整数型セットの属性が指定された整数型の属性の値を保持しているかどうかを判定します。- パラメータ:
attribute- 整数属性- 戻り値:
- この整数集合属性に
attributeの値が含まれる場合は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の場合に同等とみなされます。objectはnullではありません。objectは、クラスSetOfIntegerSyntaxのインスタンスです。- この整数型セットの属性のメンバーと
objectのメンバーが同じである。
- オーバーライド:
equals、クラスObject- パラメータ:
object- 比較するObject- 戻り値:
objectがこの整数集合属性と同等である場合はtrue、そうでない場合はfalse- 関連項目:
Object.hashCode()、HashMap
-
hashCode
public int hashCode()
この整数型セットの属性のハッシュ・コード値を返します。 ハッシュ・コードは正規配列形式の範囲の下限と上限の合計、または空のセットの場合0です。- オーバーライド:
hashCode、クラスObject- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
-