1
0
mirror of https://github.com/php/php-src.git synced 2026-04-12 18:43:37 +02:00
Files
archived-php-src/ext/spl/examples/findfile.inc
Peter Kokot 1c850bfcca Sync leading and final newlines in source code files
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
2018-10-14 12:55:24 +02:00

66 lines
1.6 KiB
PHP

<?php
/** @file findfile.inc
* @ingroup Examples
* @brief class FindFile
* @author Marcus Boerger
* @date 2003 - 2005
*
* SPL - Standard PHP Library
*/
if (!class_exists("FindFile", false)) require_once("findfile.inc");
if (!class_exists("AppendIterator", false)) require_once("appenditerator.inc");
/** @ingroup Examples
* @brief Base class to find files
* @author Marcus Boerger
* @version 1.1
*
*/
class FindFile extends FilterIterator
{
/** @internal filename to find */
private $file;
/** Construct from path and filename
*
* @param $path the directory to search in
* If path contains ';' then this parameter is split and every
* part of it is used as separate directory.
* @param $file the name of the files to search fro
*/
function __construct($path, $file)
{
$this->file = $file;
$list = split(PATH_SEPARATOR, $path);
if (count($list) <= 1) {
parent::__construct(new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path)));
} else {
$it = new AppendIterator();
foreach($list as $path) {
$it->append(new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path)));
}
parent::__construct($it);
}
}
/** @return whether the current file matches the given filename
*/
function accept()
{
return !strcmp($this->current(), $this->file);
}
/** @return the filename to search for.
* @note This may be overloaded and contain a regular expression for an
* extended class that uses regular expressions to search.
*/
function getSearch()
{
return $this->file;
}
}
?>