IteratorTools::ensureTraversable() - Code Metrics - Inspection of "Add doc" - K-Phoen/rulerz - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 7105b6...cd12e3 )

by Kévin

created 2016-09-11 10:04 UTC

IteratorTools::ensureTraversable() A

↳ Parent: IteratorTools

Complexity

Conditions	3
Paths	3

Size

Total Lines	12
Code Lines	6

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	12
rs	9.4285
c	0
b	0
f	0
cc	3
eloc	6
nc	3
nop	1

<?php

namespace RulerZ\Result;

use ArrayIterator;

/**
 * Set of utility methods to create traversable objects from various inputs.
 */
class IteratorTools
{
    /**
     * Ensures that the given items are \Traversable.
     *
     * Usage:
     *
     * ```
     * IteratorTools::ensureTraversable([1, 2, 3]);
     * IteratorTools::ensureTraversable(new \ArrayIterator([1, 2, 3]));
     * ```
     *
     * @param $items
     *
     * @return \Traversable
     *
     * @throws \InvalidArgumentException
     */
    public static function ensureTraversable($items)
    {
        if ($items instanceof \Traversable) {
            return $items;
        }

        if (is_array($items)) {
            return self::fromArray($items);
        }

        throw new \InvalidArgumentException('Un-handled argument of type: '.get_class($items));
    }

    /**
     * Creates an iterator from an array.
     *
     * Usage:
     *
     * ```
     * IteratorTools::fromArray([1, 2, 3]);
     * ```
     *
     * @param array $results
     *
     * @return \ArrayIterator
     */
    public static function fromArray(array $results)
    {
        return new ArrayIterator($results);
    }

    /**
     * Creates an iterator from a generator.
     *
     * Example of valid usage:
     *
     * ```
     * IteratorTools::fromGenerator(function() {
     *     yield 1;
     *     yield 2;
     *     yield 3;
     * });
     * ```
     *
     * @param callable $generatorCallable A callable, which will return a generator once called.
     *
     * @return \Iterator
     */
    public static function fromGenerator(callable $generatorCallable)
    {
        return $generatorCallable();
    }
}


1			<?php
2
3			namespace RulerZ\Result;
4
5			use ArrayIterator;
6
7			/**
8			* Set of utility methods to create traversable objects from various inputs.
9			*/
10			class IteratorTools
11			{
12			/**
13			* Ensures that the given items are \Traversable.
14			*
15			* Usage:
16			*
17			* ```
18			* IteratorTools::ensureTraversable([1, 2, 3]);
19			* IteratorTools::ensureTraversable(new \ArrayIterator([1, 2, 3]));
20			* ```
21			*
22			* @param $items
23			*
24			* @return \Traversable
25			*
26			* @throws \InvalidArgumentException
27			*/
28			public static function ensureTraversable($items)
29			{
30			if ($items instanceof \Traversable) {
31			return $items;
32			}
33
34			if (is_array($items)) {
35			return self::fromArray($items);
36			}
37
38			throw new \InvalidArgumentException('Un-handled argument of type: '.get_class($items));
39			}
40
41			/**
42			* Creates an iterator from an array.
43			*
44			* Usage:
45			*
46			* ```
47			* IteratorTools::fromArray([1, 2, 3]);
48			* ```
49			*
50			* @param array $results
51			*
52			* @return \ArrayIterator
53			*/
54			public static function fromArray(array $results)
55			{
56			return new ArrayIterator($results);
57			}
58
59			/**
60			* Creates an iterator from a generator.
61			*
62			* Example of valid usage:
63			*
64			* ```
65			* IteratorTools::fromGenerator(function() {
66			* yield 1;
67			* yield 2;
68			* yield 3;
69			* });
70			* ```
71			*
72			* @param callable $generatorCallable A callable, which will return a generator once called.
73			*
74			* @return \Iterator
75			*/
76			public static function fromGenerator(callable $generatorCallable)
77			{
78			return $generatorCallable();
79			}
80			}
81

K-Phoen / rulerz

Push — master ( 7105b6...cd12e3 )

IteratorTools::ensureTraversable() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like