javax.print.attribute

Класс SetOfIntegerSyntax

java.lang. Объект

javax.print.attribute. SetOfIntegerSyntax

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

Прямые Известные Подклассы:

CopiesSupported, JobImpressionsSupported, JobKOctetsSupported, JobMediaSheetsSupported, NumberUpSupported, PageRanges

public abstract class SetOfIntegerSyntax
extends Object
implements Serializable, Cloneable

SetOfIntegerSyntax класса является абстрактный class, обеспечивающий общую реализацию всех атрибутов, значение которых является рядом неотрицательных целых чисел. Это включает атрибуты, значение которых является единственным диапазоном целых чисел и атрибутов, значение которых является рядом диапазонов целых чисел.

Можно создать экземпляр SetOfIntegerSyntax, давая это в "строковой форме." Строка состоит из нуля или более разделенных от запятой целочисленных групп. Каждая целочисленная группа состоит из любого одного целого числа, два целых числа, разделенные дефисом (-), или два целых числа, разделенные двоеточием (:). Каждое целое число состоит из одной или более десятичных цифр (0 через 9). Пробельные символы не могут появиться в пределах целого числа, но иначе игнорируются. Например: "", "1", "5-10", "1:2, 4".

Можно также создать экземпляр SetOfIntegerSyntax, давая это в "форме массива." Форма массива состоит из массива нуля или большего количества целочисленных групп, где каждая целочисленная группа является длиной 1 или длиной 2 массива ints; например, int[0][], int[][]{{1}}, int[][]{{5,10}}, int[][]{{1,2},{4}}.

И в строковой форме и в форме массива, каждая последовательная целочисленная группа дает диапазон целых чисел, которые будут включены в набор. Первое целое число в каждой группе дает нижнюю границу диапазона; второе целое число в каждой группе дает верхнюю границу диапазона; если есть только одно целое число в группе, верхняя граница является тем же самым как нижней границей. Если верхняя граница является меньше чем нижняя граница, она обозначает нулевой диапазон (никакие значения). Если верхняя граница равна нижней границе, она обозначает диапазон, состоящий из единственного значения. Если верхняя граница больше чем нижняя граница, она обозначает диапазон, состоящий больше чем из одного значения. Диапазоны могут появиться в любом порядке и позволяются наложиться. Объединение всех диапазонов дает содержание набора. Как только экземпляр SetOfIntegerSyntax создается, его значение неизменное.

Значение объекта SetOfIntegerSyntax фактически сохранено в "канонической форме массива." Это - то же самое как форма массива, кроме нет никаких нулевых диапазонов; элементы набора представляются в как немного диапазонов насколько возможно (то есть, накладывающиеся диапазоны объединяются); диапазоны кажутся в порядке возрастания; и каждый диапазон всегда представляется как длина два массива ints в форме {нижняя граница, верхняя граница}. Пустое множество представляется как массив нулевой длиной.

У 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) Определите самое маленькое целое число в этом атрибуте набора целого числа, который больше чем данное значение.
Строка	toString() Возвращает строковое значение, соответствующее этому атрибуту набора целого числа.

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

SetOfIntegerSyntax

protected SetOfIntegerSyntax(String members)

Создайте новый атрибут набора целого числа с данными элементами в строковой форме.

Параметры:

members - Элементы множества в строковой форме. Если ноль, пустое множество создается.

Броски:

IllegalArgumentException - (Исключение непроверенное) Брошенный, если members не повинуется надлежащему синтаксису.

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int[][] members)

Создайте новый атрибут набора целого числа с данными элементами в форме массива.

Параметры:

members - Элементы множества в форме массива. Если ноль, пустое множество создается.

Броски:

NullPointerException - (Исключение непроверенное) Брошенный, если любой элемент members нуль.

IllegalArgumentException - (Исключение непроверенное) Брошенный, если любой элемент members не длина один, или длина два выстраивают или если любой ненулевой диапазон в members имеет нижнюю границу меньше чем нуль.

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int member)

Создайте новый атрибут набора целого числа, содержащий единственное целое число.

Параметры:

member - Элемент множества.

Броски:

IllegalArgumentException - (Исключение непроверенное) Брошенный, если member меньше чем нуль.

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int lowerBound,
                             int upperBound)

Создайте новый атрибут набора целого числа, содержащий единственный диапазон целых чисел. Если нижняя граница больше чем верхняя граница (нулевой диапазон), пустое множество создается.

Параметры:

lowerBound - Нижняя граница диапазона.

upperBound - Верхняя граница диапазона.

Броски:

IllegalArgumentException - (Исключение непроверенное) Брошенный, если диапазон является ненулем и lowerBound меньше чем нуль.

Деталь метода

getMembers

public int[][] getMembers()

Получите этот набор целого числа элементы атрибута в канонической форме массива. Возвращенный массив "безопасен;" клиент может изменить это, не влияя на этот атрибут набора целого числа.

Возвраты:

Этот набор целого числа элементы атрибута в канонической форме массива.

содержит

public boolean contains(int x)

Определите, содержит ли этот атрибут набора целого числа данное значение.

Параметры:

x - Целочисленное значение.

Возвраты:

Истина, если этот атрибут набора целого числа содержит значение x, ложь иначе.

содержит

public boolean contains(IntegerSyntax attribute)

Определите, содержит ли этот атрибут набора целого числа значение данного целочисленного атрибута.

Параметры:

attribute - Целочисленный атрибут.

Возвраты:

Истина, если этот атрибут набора целого числа содержит theAttribute's значение, ложь иначе.

затем

public int next(int x)

Определите самое маленькое целое число в этом атрибуте набора целого числа, который больше чем данное значение. Если нет никаких целых чисел в этом атрибуте набора целого числа, больше чем данное значение, -1 возвращается. (Так как атрибут набора целого числа может только содержать неотрицательные значения, -1 никогда не будет появляться в наборе.) Можно использовать next() метод, чтобы выполнить итерации через целочисленные значения в наборе целого числа приписывает в порядке возрастания, как это:

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

Параметры:

x - Целочисленное значение.

Возвраты:

Самое маленькое целое число в этом атрибуте набора целого числа, который больше чем x, или -1 если никакое целое число в этом атрибуте набора целого числа не больше чем x.

равняется

public boolean equals(Object object)

Возвраты, эквивалентен ли этот атрибут набора целого числа переданному в объекте. Чтобы быть эквивалентными, все следующие условия должны быть истиной:

1. object не нуль.
2. object экземпляр class SetOfIntegerSyntax.
3. Этот набор целого числа элементы атрибута и object's элементы то же самое.

Переопределения:

equals в class Object

Параметры:

object - Объект сравниться с.

Возвраты:

Истина, если object эквивалентно этому атрибуту набора целого числа, ложь иначе.

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает значение хэш-кода для этого атрибута набора целого числа. Хэш-код является суммой нижних и верхних границ диапазонов в канонической форме массива, или 0 для пустого множества.

Переопределения:

hashCode в class Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает строковое значение, соответствующее этому атрибуту набора целого числа. Строковое значение является строкой нулевой длиной, если этот набор пуст. Иначе, строковое значение является списком разделенных запятой значений диапазонов в канонической форме массива, где каждый диапазон представляется как "i" если нижняя граница равняется верхней границе или "i-j" иначе.

Переопределения:

toString в class Object

Возвраты:

строковое представление объекта.