mirror of
https://github.com/php/php-src.git
synced 2026-03-24 16:22:37 +01:00
1c850bfcca
This patch adds missing newlines, trims multiple redundant final newlines into a single one, and trims redundant leading newlines. According to POSIX, a line is a sequence of zero or more non-' <newline>' characters plus a terminating '<newline>' character. [1] Files should normally have at least one final newline character. C89 [2] and later standards [3] mention a final newline: "A source file that is not empty shall end in a new-line character, which shall not be immediately preceded by a backslash character." Although it is not mandatory for all files to have a final newline fixed, a more consistent and homogeneous approach brings less of commit differences issues and a better development experience in certain text editors and IDEs. [1] http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_206 [2] https://port70.net/~nsz/c/c89/c89-draft.html#2.1.1.2 [3] https://port70.net/~nsz/c/c99/n1256.html#5.1.1.2
60 lines
1.7 KiB
PHP
60 lines
1.7 KiB
PHP
<?php
|
|
|
|
/** @file recursivearrayiterator.inc
|
|
* @ingroup Examples
|
|
* @brief class RecursiveArrayIterator
|
|
* @author Marcus Boerger
|
|
* @date 2003 - 2009
|
|
*
|
|
* SPL - Standard PHP Library
|
|
*/
|
|
|
|
/** @ingroup SPL
|
|
* @brief A recursive array iterator
|
|
* @author Marcus Boerger
|
|
* @version 1.0
|
|
* @since PHP 5.1
|
|
*
|
|
* Passes the RecursiveIterator interface to the inner Iterator and provides
|
|
* the same functionality as FilterIterator. This allows you to skip parents
|
|
* and all their childs before loading them all. You need to care about
|
|
* function getChildren() because it may not always suit your needs. The
|
|
* builtin behavior uses reflection to return a new instance of the exact same
|
|
* class it is called from. That is you extend RecursiveFilterIterator and
|
|
* getChildren() will create instance of that class. The problem is that doing
|
|
* this does not transport any state or control information of your accept()
|
|
* implementation to the new instance. To overcome this problem you might
|
|
* need to overwrite getChildren(), call this implementation and pass the
|
|
* control vaules manually.
|
|
*/
|
|
class RecursiveArrayIterator extends ArrayIterator implements RecursiveIterator
|
|
{
|
|
/** @return whether the current element has children
|
|
*/
|
|
function hasChildren()
|
|
{
|
|
return is_array($this->current());
|
|
}
|
|
|
|
/** @return an iterator for the current elements children
|
|
*
|
|
* @note the returned iterator will be of the same class as $this
|
|
*/
|
|
function getChildren()
|
|
{
|
|
if ($this->current() instanceof self)
|
|
{
|
|
return $this->current();
|
|
}
|
|
if (empty($this->ref))
|
|
{
|
|
$this->ref = new ReflectionClass($this);
|
|
}
|
|
return $this->ref->newInstance($this->current());
|
|
}
|
|
|
|
private $ref;
|
|
}
|
|
|
|
?>
|