NewArray.php

<?php

/**
 * @author Peter Robinett <[email protected]>
 * @since 2010-08-03
 */

function array2NewArray (array $arr) {
    return new NewArray($arr);
}

function NewArray2array(NewArray $newArray) {
    return $newArray->toArray();
}

class NewArray extends ArrayIterator {
    public function toArray() {
        return $this->getArrayCopy();
    }
    
    public function merge($arr) {
        return new NewArray(array_merge($this->toArray(), $this->input2array($arr)));
    }
    
    public function filter($callback = NULL) {
        if (is_null($callback)) {
            return new NewArray(array_filter($this->toArray()));
        } else {
            return new NewArray(array_filter($this->toArray(), $callback));
        }
    }
    
    private function input2array($arr) {
        if (!($arr instanceof NewArray) && !(is_array($arr))) {
            throw new Exception('An array-like object must be given.');
        }
        return ($arr instanceof NewArray) ? $arr->toArray() : $arr;
    }
}

$arr = array2NewArray(array(1, 2, 3));

print_r($arr->merge(array(4, 5, 6)));

?>