CachingRecursiveIterator Class Reference

Inheritance diagram for CachingRecursiveIterator:

Collaboration diagram for CachingRecursiveIterator:

Public Member Functions
	__call ($func, $params)
	__toString ()
	current ()
	getChildren ()
	getInnerIterator ()
	hasChildren ()
	hasNext ()
	key ()
	next ()
	rewind ()
	valid ()

Public Attributes
const	CALL_TOSTRING = 0x00000001
const	CATCH_GET_CHILD = 0x00000002
$this	getChildren = NULL
const	TOSTRING_USE_CURRENT = 0x00000020
const	TOSTRING_USE_KEY = 0x00000010

Detailed Description

Compatibility to PHP 5.0.

Author

Marcus Boerger

Version

1.2

Deprecated:

Class RecursiveCachingIterator was named CachingRecursiveIterator until PHP 5.0.6.

See Also

RecursiveCachingIterator

Definition at line 24 of file cachingrecursiveiterator.inc.

Member Function Documentation

CachingIterator::__call (   $func,   $params  )

inherited

Aggregate the inner iterator.

Parameters

func	Name of method to invoke
params	Array of parameters to pass to method

Definition at line 122 of file cachingiterator.inc.

    {
        return call_user_func_array(array($this->it, $func), $params);
    }

CachingIterator::__toString ( )

inherited

Returns

the string represenatation that was generated for the current element

Exceptions

exception

when CALL_TOSTRING was not specified in constructor

Definition at line 131 of file cachingiterator.inc.

References CachingIterator\$current, CachingIterator\$key, and CachingIterator\$strValue.

    {
        if ($this->flags & self::TOSTRING_USE_KEY)
        {
            return $this->key;
        }
        else if ($this->flags & self::TOSTRING_USE_CURRENT)
        {
            return $this->current;
        }
        if (!$this->flags & self::CALL_TOSTRING)
        {
            throw new exception('CachingIterator does not fetch string value (see CachingIterator::__construct)');
        }
        return $this->strValue;
    }

CachingIterator::current ( )

inherited

Returns

the current element

Implements Iterator.

Definition at line 105 of file cachingiterator.inc.

References CachingIterator\$current.

Referenced by CachingIterator\next().

    {
        return $this->current;
    }

RecursiveCachingIterator::getChildren ( )

inherited

Returns

An Iterator for the children

Implements RecursiveIterator.

Definition at line 93 of file recursivecachingiterator.inc.

References RecursiveCachingIterator\$getChildren.

Referenced by RecursiveCachingIterator\next().

    {
        return $this->getChildren;
    }

CachingIterator::getInnerIterator ( )

inherited

Returns

The inner iterator

Implements OuterIterator.

Definition at line 151 of file cachingiterator.inc.

References CachingIterator\$it.

    {
        return $this->it;
    }

RecursiveCachingIterator::hasChildren ( )

inherited

Returns

whether the current element has children

Note

The check whether the Iterator for the children can be created was already executed. Hence when flag CATCH_GET_CHILD was given in constructor this fucntion returns false so that getChildren does not try to access those children.

Implements RecursiveIterator.

Definition at line 86 of file recursivecachingiterator.inc.

References RecursiveCachingIterator\$hasChildren.

Referenced by RecursiveCachingIterator\next().

    {
        return $this->hasChildren;
    }

CachingIterator::hasNext ( )

inherited

Returns

whether there is one more element

Definition at line 98 of file cachingiterator.inc.

    {
        return $this->it->valid();
    }

CachingIterator::key ( )

inherited

Returns

the current key

Implements Iterator.

Definition at line 112 of file cachingiterator.inc.

References CachingIterator\$key.

Referenced by CachingIterator\next().

    {
        return $this->key;
    }

RecursiveCachingIterator::next ( )

inherited

Forward to next element if necessary then an Iterator for the Children will be created.

Implements Iterator.

Definition at line 49 of file recursivecachingiterator.inc.

References RecursiveCachingIterator\$ref, RecursiveCachingIterator\getChildren(), and RecursiveCachingIterator\hasChildren().

    {
        if ($this->hasChildren = $this->it->hasChildren())
        {
            try
            {
                $child = $this->it->getChildren();
                if (!$this->ref)
                {
                    $this->ref = new ReflectionClass($this);
                }
                $this->getChildren = $ref->newInstance($child, $this->flags);
            }
            catch(Exception $e)
            {
                if (!$this->flags & self::CATCH_GET_CHILD)
                {
                    throw $e;
                }
                $this->hasChildren = false;
                $this->getChildren = NULL;
            }
        } else
        {
            $this->getChildren = NULL;
        }
        parent::next();
    }

Here is the call graph for this function:

RecursiveCachingIterator::rewind ( )

inherited

Rewind Iterator.

Implements Iterator.

CachingIterator::valid ( )

inherited

Returns

whether the iterator is valid

Implements Iterator.

Definition at line 91 of file cachingiterator.inc.

References CachingIterator\$valid.

Referenced by CachingIterator\next().

    {
        return $this->valid;
    }

Member Data Documentation

const CachingIterator::CALL_TOSTRING = 0x00000001

inherited

Definition at line 30 of file cachingiterator.inc.

Referenced by DirectoryGraphIterator\__construct(), and DirectoryTreeIterator\__construct().

const CachingIterator::CATCH_GET_CHILD = 0x00000002

inherited

Definition at line 31 of file cachingiterator.inc.

Referenced by DirectoryGraphIterator\__construct(), and DirectoryTreeIterator\__construct().

$this RecursiveCachingIterator::getChildren = NULL

inherited

Definition at line 42 of file recursivecachingiterator.inc.

const CachingIterator::TOSTRING_USE_CURRENT = 0x00000020

inherited

Definition at line 33 of file cachingiterator.inc.

const CachingIterator::TOSTRING_USE_KEY = 0x00000010

inherited

Definition at line 32 of file cachingiterator.inc.

---

The documentation for this class was generated from the following file:

• cachingrecursiveiterator.inc