123 lines
2.8 KiB
PHP
123 lines
2.8 KiB
PHP
|
<?php
|
||
|
|
/**
|
||
|
|
* This file is part of the Peast package
|
||
|
|
*
|
||
|
|
* (c) Marco Marchiò <marco.mm89@gmail.com>
|
||
|
|
*
|
||
|
|
* For the full copyright and license information refer to the LICENSE file
|
||
|
|
* distributed with this source code
|
||
|
|
*/
|
||
|
|
namespace Peast;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Nodes query class
|
||
|
|
*
|
||
|
|
* @author Marco Marchiò <marco.mm89@gmail.com>
|
||
|
|
*/
|
||
|
|
class Query implements \IteratorAggregate, \Countable
|
||
|
|
{
|
||
|
|
/**
|
||
|
|
* Current matches
|
||
|
|
*
|
||
|
|
* @var Selector\Matches
|
||
|
|
*/
|
||
|
|
protected $matches;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Options array
|
||
|
|
*
|
||
|
|
* @var array
|
||
|
|
*/
|
||
|
|
protected $options;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Class constructor. Available options are:
|
||
|
|
* - encoding: selectors encoding. If not specified the
|
||
|
|
* parser will assume UTF-8.
|
||
|
|
*
|
||
|
|
* @param Syntax\Node\Program $root Root node
|
||
|
|
* @param array $options Options array
|
||
|
|
*/
|
||
|
|
public function __construct(Syntax\Node\Program $root, $options = array())
|
||
|
|
{
|
||
|
|
$this->matches = new Selector\Matches();
|
||
|
|
$this->matches->addMatch($root);
|
||
|
|
$this->options = $options;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Finds nodes matching the given selector starting from the
|
||
|
|
* current matched nodes, if any, or from the root
|
||
|
|
*
|
||
|
|
* @param string $selector Selector
|
||
|
|
*
|
||
|
|
* @return $this
|
||
|
|
*
|
||
|
|
* @throws Selector\Exception
|
||
|
|
*/
|
||
|
|
public function find($selector)
|
||
|
|
{
|
||
|
|
$parser = new Selector\Parser($selector, $this->options);
|
||
|
|
$selector = $parser->parse();
|
||
|
|
$this->matches = $selector->exec($this->matches);
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Executes the given selector on the current nodes and filters
|
||
|
|
* out the nodes which don't match
|
||
|
|
*
|
||
|
|
* @param string $selector Selector
|
||
|
|
*
|
||
|
|
* @return $this
|
||
|
|
*
|
||
|
|
* @throws Selector\Exception
|
||
|
|
*/
|
||
|
|
public function filter($selector)
|
||
|
|
{
|
||
|
|
$parser = new Selector\Parser($selector, $this->options);
|
||
|
|
$selector = $parser->parse(true);
|
||
|
|
$this->matches->filter(function ($node, $parent) use ($selector) {
|
||
|
|
$newMatch = new Selector\Matches();
|
||
|
|
$newMatch->addMatch($node, $parent);
|
||
|
|
return $selector->exec($newMatch)->getMatches();
|
||
|
|
});
|
||
|
|
return $this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the number of matched nodes
|
||
|
|
*
|
||
|
|
* @return int
|
||
|
|
*/
|
||
|
|
#[\ReturnTypeWillChange]
|
||
|
|
public function count()
|
||
|
|
{
|
||
|
|
return $this->matches->count();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the node at the given index
|
||
|
|
*
|
||
|
|
* @param int $index Index
|
||
|
|
*
|
||
|
|
* @return array
|
||
|
|
*
|
||
|
|
* @throws \Exception
|
||
|
|
*/
|
||
|
|
public function get($index)
|
||
|
|
{
|
||
|
|
return $this->matches->get($index)[0];
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the nodes iterator
|
||
|
|
*
|
||
|
|
* @return \ArrayIterator
|
||
|
|
*/
|
||
|
|
#[\ReturnTypeWillChange]
|
||
|
|
public function getIterator()
|
||
|
|
{
|
||
|
|
return new \ArrayIterator($this->matches->getNodes());
|
||
|
|
}
|
||
|
|
}
|