Класс 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 не является массивом длины один или два, или если какой-либо 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 - объект для сравнения

Возвращает:

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

См. также:

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

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

См. также:

toString

public String toString()

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

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

© 1993, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/SetOfIntegerSyntax.html