zicht / itertools

 * @return FilterIterator

 * @deprecated Use iterable($iterable)->filter($strategy), will be removed in version 3.0

 */

function filter()

{

    // note, once we stop supporting php 5.5, we can rewrite the code below

    // to the filter(...$iterables) structure.

    // http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list

    $args = func_get_args();

    switch (sizeof($args)) {

        case 1:

            $strategy = null;

            $iterable = $args[0];

            break;

        case 2:

            $strategy = $args[0];

            $iterable = $args[1];

            break;

        default:

            throw new \InvalidArgumentException('filter requires either one (iterable) or two (strategy, iterable) arguments');

    }

    if (!($iterable instanceof FilterInterface)) {

        $iterable = iterable($iterable);

    }

    return $iterable->filter($strategy);

}

/**

 * Make an iterator that returns values from $iterable where the

 * @return UniqueIterator

 * @deprecated Use iterable($iterable)->unique($strategy), will be removed in version 3.0

 */

function unique()

{

    $args = func_get_args();

    switch (sizeof($args)) {

        case 1:

            $strategy = null;

            $iterable = $args[0];

            break;

        case 2:

            $strategy = $args[0];

            $iterable = $args[1];

            break;

        default:

            throw new \InvalidArgumentException('unique requires either one (iterable) or two (strategy, iterable) arguments');

    }

    if (!($iterable instanceof UniqueInterface)) {

        $iterable = iterable($iterable);

    }

    return $iterable->unique($strategy);

}

/**

 * Returns an iterator where the values from $strategy are unique

 * @return UniqueIterator

 * @deprecated Use iterable($iterable)->unique($strategy), will be removed in version 3.0

 */

function uniqueBy($strategy, $iterable) // phpcs:ignore Zicht.NamingConventions.Functions.GlobalNaming

{

    $args = func_get_args();

    switch (sizeof($args)) {

        case 1:

            $strategy = null;

            $iterable = $args[0];

            break;

        case 2:

            $strategy = $args[0];

            $iterable = $args[1];

            break;

        default:

            throw new \InvalidArgumentException('unique requires either one (iterable) or two (strategy, iterable) arguments');

    }

    if (!($iterable instanceof UniqueInterface)) {

        $iterable = iterable($iterable);

    }

    return $iterable->unique($strategy);

}

/**

 * Returns true when one or more element of $iterable is not empty, otherwise returns false

 * @return boolean

 * @deprecated Use iterable($iterable)->any($strategy), will be removed in version 3.0

 */

function any()

{

    $args = func_get_args();

    switch (sizeof($args)) {

        case 1:

            $strategy = null;

            $iterable = $args[0];

            break;

        case 2:

            $strategy = $args[0];

            $iterable = $args[1];

            break;

        default:

            throw new \InvalidArgumentException('any requires either one (iterable) or two (strategy, iterable) arguments');

    }

    if (!($iterable instanceof AllInterface)) {

        $iterable = iterable($iterable);

    }

    return $iterable->any($strategy);

}

/**

 * Returns true when all elements of $iterable are not empty, otherwise returns false

 * @return boolean

 * @deprecated Use iterable($iterable)->all($strategy), will be removed in version 3.0

 */

function all()

{

    $args = func_get_args();

    switch (sizeof($args)) {

        case 1:

            $strategy = null;

            $iterable = $args[0];

            break;

        case 2:

            $strategy = $args[0];

            $iterable = $args[1];

            break;

        default:

            throw new \InvalidArgumentException('all requires either one (iterable) or two (strategy, iterable) arguments');

    }

    if (!($iterable instanceof AllInterface)) {

        $iterable = iterable($iterable);

    }

    return $iterable->all($strategy);

}

/**

 * Make an iterator that contains a slice of $iterable