Класс 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 содержит операции для возвращения элементов множества в каноническом формате массива, проверки, является ли заданное целое число элементом множества, и итерации по элементам множества.

См. также:

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

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 не является массивом длины один или два, или если какой-либо 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 - атрибут целого типа
Возвращает:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/SetOfIntegerSyntax.html