Класс SetOfIntegerSyntax

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