Класс 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}}.

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

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

Класс SetOfIntegerSyntax имеет операции для возвращения элементов множества в каноническом формате массива, для проверки, является ли заданное целое число элементом множества, и для перебора элементов множества.

См. также:

Сериализованная форма

Краткое описание конструкторов

SetOfIntegerSyntax(int member)

SetOfIntegerSyntax(int[][] members)

SetOfIntegerSyntax(int lowerBound,
 int upperBound)

SetOfIntegerSyntax(String members)

Модификатор	Конструктор	Описание
`protected`	Создаёт новый атрибут множества целых чисел, содержащий одно целое число.
`protected`	Создаёт новый атрибут множества целых чисел с заданными элементами в формате массива.
`protected`	Создаёт новый атрибут множества целых чисел, содержащий один диапазон целых чисел.
`protected`	Создаёт новый атрибут множества целых чисел с заданными элементами в строковом формате.

Краткое описание методов

Модификатор и тип	Метод	Описание
`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, или если какой-либо диапазон non-null в members имеет нижнюю границу меньше нуля

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int member)

Создаёт новый атрибут «множество целых чисел», содержащий одно целое число.

Параметры:: member - элемент множества
Исключения:: IllegalArgumentException - если member отрицательно

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int lowerBound, int upperBound)

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

Параметры:: lowerBound - Нижняя граница диапазона; upperBound - Верхняя граница диапазона
Исключения:: IllegalArgumentException - если диапазон non-null и lowerBound меньше нуля

Подробное описание методов

getMembers

public int[][] getMembers()

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

Возвращает:: элементы этого атрибута «множество целых чисел» в каноническом формате массива

contains

public boolean contains(int x)

Определить, содержит ли этот атрибут «множество целых чисел» заданное значение.

Параметры:: x - значение целого числа
Возвращает:: true если этот атрибут «множество целых чисел» содержит значение x, false в противном случае

contains

public boolean contains(IntegerSyntax attribute)

Определить, содержит ли этот атрибут «множество целых чисел» значение заданного атрибута целого числа.

Параметры:: attribute - атрибут целого числа
Возвращает:: true если этот атрибут «множество целых чисел» содержит значение attribute, false в противном случае

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.

equals

public boolean equals(Object object)

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

object не является null.
object является экземпляром класса SetOfIntegerSyntax.
Элементы этого атрибута «множество целых чисел» и элементы object совпадают.

Переопределяет:

equals в классе Object

Параметры:

object - Object для сравнения

Возвращает:

true если object эквивалентен этому атрибуту «множество целых чисел», false в противном случае

См. также:

hashCode

public int hashCode()

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

Переопределяет:

hashCode в классе Object

Возвращает:

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

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/print/attribute/SetOfIntegerSyntax.html