jesseschalken/set

java.utils.Set for PHP implementing ArrayAccess, Countable and IteratorAggregate with O(1) conversion to/from array keys

v1.0.2 2016-01-18 00:21 UTC

Requires (Dev)

• phpunit/phpunit: ^5.1.4

MIT

• Jesse Schalken

README

java.utils.Set for PHP implementing ArrayAccess, Countable, IteratorAggregate with O(1) conversion to/from array keys.

Uses array_replace(), array_intersect_key() and array_diff_key() for fast union, intersection and difference (addAll(), retainAll(), removeAll()).

use JesseSchalken\Set;

// Create a set from an array, Set or Traversable
$set = new Set([1, 2, 3]);
$set = new Set($set);
$set = new Set(new \ArrayIterator($set->toArray()));

// Add and remove elements
$set->add(4);
$set->remove(2);
var_export($set->contains(4)); // true
var_export($set->contains(2)); // false

// Clear and check if empty
$set->clear();
var_export($set->isEmpty()); // true

// Add and remove other arrays, Sets or Traversables 
$set->addAll(['red', 'green', 'blue', 54]);
$set->removeAll(new \ArrayObject(['green', 54]));

// Check subset/superset
var_export($set->containsAll(new Set(['red', 'blue']))); // true
var_export($set->toArray()); // ['red', 'blue']

// Intersect another array, Set or Traversable
$set->retainAll(['blue', 'green']);
var_export($set->toArray()); // ['blue']
var_export($set->size()); // 1
var_export($set->equals(['blue'])); // true

// Convert to array keys
$set = new Set([1, 2]);
var_export($set->toArrayKeys()); // [1 => true, 2 => true]

// Convert from array keys
$set = Set::fromArrayKeys([7 => true, 3 => 'string']);
var_export($set->toArray()); // [7, 3]

// Use ArrayAccess
$set = new Set();
$set['red']   = true; // add
$set['green'] = true; // add
$set['red']   = false; // remove
var_export($set['green']); // true
var_export($set['blue']); // false
var_export($set['red']); // false

// Use IteratorAggregate
foreach ($set as $v) {
    var_export($v); // blue
}

// Use Countable
var_export(count($set)); // 1