Download the PHP package remorhaz/int-rangesets without Composer
On this page you can find all versions of the php package remorhaz/int-rangesets. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download remorhaz/int-rangesets
More information about remorhaz/int-rangesets
Files in remorhaz/int-rangesets
Package int-rangesets
Short Description Integer range sets manipulation
License MIT
Homepage https://github.com/remorhaz/php-int-rangesets
Informations about the package int-rangesets
Integer Range Sets
This small library allows manipulating integer sets.
Requirements
- PHP 8.1, 8.2, 8.3.
Installation
Usage
Introduction
Set is represented in a form of collection of continuous ranges; each range is represented by a pair of integers denoting it's first and last values.
Range
Range cannot be empty, but can contain only one integer; in that case it's first and last values are the same.
Ranges are immutable. Any operation on a range creates a new instance, leaving the original one intact.
Range sets
All ranges in a set are normalized: they follow each other in ascending order and are separated by non-empty gaps, so none of them follow immediately after previous one or overlap.
Range sets are also immutable. Any operation on a set creates a new instance, leaving the original one intact.
Merging of ranges requires resources, so there's a fast, but unsafe way to initialize set with ranges. In this case constructing code must take full responsibility for normalization of ranges.
WARNING: Operations on non-normalized range sets will return incorrect results! Use create()
method with arbitrary range lists.
Available operations
In all examples $a
, $b
and $result
are objects implementing \Remorhaz\IntRangeSets\RangeSetInterface
.
Operation | Formula | Example |
---|---|---|
Union | A ∪ B | $result = $a->createUnion($b); |
Intersection | A ∩ B | $result = $a->createIntersection($b); |
Symmetric difference | A ∆ B | $result = $a->createSymmetricDifference($b); |
License
This library is licensed under MIT license.