TDoG-Skin/vendor/hoa/iterator/RegularExpression.php
2024-08-17 19:13:54 +08:00

401 lines
9.2 KiB
PHP
Executable File

<?php
/**
* Hoa
*
*
* @license
*
* New BSD License
*
* Copyright © 2007-2017, Hoa community. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the name of the Hoa nor the names of its contributors may be
* used to endorse or promote products derived from this software without
* specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
namespace Hoa\Iterator;
/**
* Class \Hoa\Iterator\RegularExpression.
*
* Re-implement the SPL RegexIterator class.
* There are too many bugs in php-src and HHVM, so we re-implement it from
* scratch without extending the existing class.
*
* Inspired by hhvm://hphp/system/php/spl/iterators/RegexIterator.php
*
* @copyright Copyright © 2007-2017 Hoa community
* @license New BSD License
*/
class RegularExpression extends Filter
{
/**
* Flag: match the entry key instead of the entry value.
*
* @const int
*/
const USE_KEY = 1;
/**
* Flag: invert match.
*
* @const int
*/
const INVERT_MATCH = 2;
/**
* Mode and preg flag: only execute match (filter) for the current entry.
*
* @const int
*/
const MATCH = 0;
/**
* Mode and preg flag: first match for the current entry.
*
* @const int
*/
const GET_MATCH = 1;
/**
* Mode and preg flag: all matches for the current entry.
*
* @const int
*/
const ALL_MATCHES = 2;
/**
* Mode and preg flag: split values for the current entry.
*
* @const int
*/
const SPLIT = 3;
/**
* Mode and preg flag: replace the current entry.
*
* @const int
*/
const REPLACE = 4;
/**
* The regular expression to match.
*
* @var string
*/
protected $_regex = null;
/**
* Operation mode, see the \RegexIterator::setMode method for a list of
* modes.
*
* @var int
*/
protected $_mode = 0;
/**
* Special flags, see the \RegexIterator::setFlag method for a list of
* available flags.
*
* @var int
*/
protected $_flags = 0;
/**
* The regular expression flags. See constants.
*
* @var int
*/
protected $_pregFlags = 0;
/**
* Current key.
*
* @var int
*/
protected $_key = 0;
/**
* Current value.
*
* @var string
*/
protected $_current = null;
/**
* Replacement.
*
* @var string
*/
public $replacement = null;
/**
* Constructor.
*
* @param \RecursiveIterator $iterator The recursive iterator to
* apply this regex filter to.
* @param string $regex The regular expression to
* match.
* @param int $mode Operation mode, please see the
* \RegexIterator::setMode method.
* @param int $flags Special flags, please see the
* \RegexIterator::setFlags method.
* @param int $pregFlags Regular expression flags,
* please see
* \RegexIterator constants.
*/
public function __construct(
\Iterator $iterator,
$regex,
$mode = self::MATCH,
$flags = 0,
$pregFlags = 0
) {
parent::__construct($iterator);
$this->_regex = $regex;
$this->setMode($mode);
$this->setFlags($flags);
$this->setPregFlags($pregFlags);
$this->replacement = null;
return;
}
/**
* Get accept status.
*
* @return bool
*/
public function accept()
{
if (is_array(parent::current())) {
return false;
}
$this->_key = parent::key();
$this->_current = parent::current();
$matches = [];
$useKey = $this->_flags & self::USE_KEY;
$subject = $useKey ? $this->_key : $this->_current;
$out = false;
switch ($this->_mode) {
case self::MATCH:
$out = 0 !== preg_match(
$this->_regex,
$subject,
$matches,
$this->_pregFlags
);
break;
case self::GET_MATCH:
$this->_current = [];
$out = 0 !== preg_match(
$this->_regex,
$subject,
$this->_current,
$this->_pregFlags
);
break;
case self::ALL_MATCHES:
$this->_current = [];
$out = 0 < preg_match_all(
$this->_regex,
$subject,
$this->_current,
$this->_pregFlags
);
break;
case self::SPLIT:
$this->_current = preg_split(
$this->_regex,
$subject,
null,
$this->_pregFlags
);
$out =
is_array($this->_current) &&
1 < count($this->_current);
break;
case self::REPLACE:
$numberOfReplacement = 0;
$result = preg_replace(
$this->_regex,
$this->replacement,
$subject,
-1,
$numberOfReplacement
);
if (null === $result || 0 === $numberOfReplacement) {
$out = false;
break;
}
if (0 !== $useKey) {
$this->_key = $result;
$out = true;
break;
}
$this->_current = $result;
$out = true;
break;
default:
$out = false;
break;
}
if (0 !== ($this->_flags & self::INVERT_MATCH)) {
return false === $out;
}
return $out;
}
/**
* Get current key.
*
* @return int
*/
public function key()
{
return $this->_key;
}
/**
* Get current value.
*
* @return string
*/
public function current()
{
return $this->_current;
}
/**
* Set mode.
*
* @param int $mode Mode.
* @return void
*/
public function setMode($mode)
{
if ($mode < self::MATCH || $mode > self::REPLACE) {
throw new \InvalidArgumentException(
'Illegal mode ' . $mode . '.'
);
}
$this->_mode = $mode;
return;
}
/**
* Set flags.
*
* @param int $flags Flags.
* @return void
*/
public function setFlags($flags)
{
$this->_flags = $flags;
return;
}
/**
* Set preg flags.
*
* @param int $pregFlags Preg flags.
* @return void
*/
public function setPregFlags($pregFlags)
{
$this->_pregFlags = $pregFlags;
return;
}
/**
* Get regular expression.
*
* @return string
*/
public function getRegex()
{
return $this->_regex;
}
/**
* Get mode.
*
* @return int
*/
public function getMode()
{
return $this->_mode;
}
/**
* Get flags.
*
* @return int
*/
public function getFlags()
{
return $this->_flags;
}
/**
* Get preg flags.
*
* @return int
*/
public function getPregFlags()
{
return $this->_pregFlags;
}
}