Класс 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 также можно создать, задав его в «массивной форме». Массивная форма состоит из массива, содержащего ноль или более групп целых чисел, где каждая группа целых чисел является массивом int длины 1 или 2; например, int[0][], int[][]{{1}}, int[][]{{5,10}}, int[][]{{1,2},{4}}.

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

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

Класс 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()`	Возвращает строковое значение, соответствующее этому атрибуту-множеству целых чисел.

Методы, объявленные в классе 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 не является массивом длины один или два либо если какой-либо 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 — значение Integer
Возвращает:: true, если этот атрибут-множество целых чисел содержит значение x, в противном случае — false

contains

public boolean contains(IntegerSyntax attribute)

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

Параметры:: attribute — атрибут Integer
Возвращает:: 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 — значение Integer
Возвращает:: наименьшее целое число в этом атрибуте-множестве целых чисел, которое больше 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, 2025, 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/25/docs/api/java.desktop/javax/print/attribute/SetOfIntegerSyntax.html