Consistent object representation of basic data types. Inheritance friendly implementation. Currently provides Arr (array) and Obj (object) classes.

Installation

Install with Composer;

composer require phrity/o

The Arr class

An object implementation of array. Implements ArrayAccess, Countable and Iterator interfaces.

Class synopsis

class Phrity\O\Arr
    implements ArrayAccess, Countable, Iterator, Phrity\Comparison\Comparable {

    /* Methods */
    public __construct(mixed ...$args)
    public offsetExists(mixed $offset) : bool
    public offsetGet(mixed $offset) : mixed
    public offsetSet(mixed $offset, mixed $value) : void
    public offsetUnset(mixed $offset) : void
    public count() : int
    public current() : mixed
    public key() : scalar
    public next() : void
    public rewind() : void
    public valid() : bool
    public previous() : void
    public forward() : void
    public __toString() : string
    public compare(mixed $compare_with) : int

    /* Inherited from ComparisonTrait */
    public equals(mixed $compare_with) : bool
    public greaterThan(mixed $compare_with) : bool
    public greaterThanOrEqual(mixed $compare_with) : bool
    public lessThan(mixed $compare_with) : bool
    public lessThanOrEqual(mixed $compare_with) : bool
}

Examples

// Constructor variants
$array = new O\Arr(); // Empty array
$array = new O\Arr([1, 2, 3]); // Numeric array
$array = new O\Arr(['a' => 1, 'b' => 2, 'c' => 3]); // Associative array
$array = new O\Arr($myclass); // Public properties to associative array
$array = new O\Arr(new O\Arr([1, 2, 3]); // Cloning

// ArrayAccess support
$array = new O\Arr([1, 2, 3]);
$array[] = 7; // [1, 2, 3, 7]
$array[0] = 5; // [5, 2, 3, 7]

// Countable support
$array = new O\Arr([1, 2, 3]);
count($array) // 3

// Iterator support
$array = new O\Arr([1, 2, 3]);
foreach ($array as $key => $value) {}

// Comparison support
$array = new O\Arr([1, 2, 3]);
$array->lessThan(new O\Arr([1, 2, 3, 4])); // true
$array->equals(new O\Arr([2, 3, 4])); // false

The Obj class

An object implementation of object.

Class synopsis

class Phrity\O\Obj
    implements Phrity\Comparison\Comparable {

    /* Methods */
    public __construct(mixed ...$args)
    public __get(string $key)
    public __set(string $key, mixed $value)
    public __isset(string $key)
    public __unset(string $key)
    public __toString() : string
    public compare(mixed $compare_with) : int

    /* Inherited from ComparisonTrait */
    public equals(mixed $compare_with) : bool
    public greaterThan(mixed $compare_with) : bool
    public greaterThanOrEqual(mixed $compare_with) : bool
    public lessThan(mixed $compare_with) : bool
    public lessThanOrEqual(mixed $compare_with) : bool
}

Examples

// Constructor variants
$object = new O\Obj(); // Empty object
$object = new O\Obj(['a' => 1, 'b' => 2, 'c' => 3]); // Object from array
$object = new O\Obj($myclass); // Public properties to object
$object = new O\Obj(new O\Obj(['a' => 1, 'b' => 2, 'c' => 3]); // Cloning

// Property access
$object = new O\Obj(['a' => 1, 'b' => 2]);
$object->a; // 1
$object->b = 5;

// Comparison support
$object = new O\Obj(['a' => 1, 'b' => 2]);
$object->lessThan(new O\Obj(['a' => 2, 'b' => 3])); // true
$object->equals(new O\Obj(['c' => 1, 'd' => 2])); // false

Versions

• 1.1 - Comparison support
• 1.0 - Arr (array) and Obj (object) classes