mirror of
https://github.com/php/php-src.git
synced 2026-04-12 18:43:37 +02:00
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
66 lines
1.6 KiB
PHP
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;
|
|
}
|
|
}
|
|
|
|
?>
|