annotate vendor/symfony/css-selector/XPath/XPathExpr.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents c2387f117808
children
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 /*
Chris@0 4 * This file is part of the Symfony package.
Chris@0 5 *
Chris@0 6 * (c) Fabien Potencier <fabien@symfony.com>
Chris@0 7 *
Chris@0 8 * For the full copyright and license information, please view the LICENSE
Chris@0 9 * file that was distributed with this source code.
Chris@0 10 */
Chris@0 11
Chris@0 12 namespace Symfony\Component\CssSelector\XPath;
Chris@0 13
Chris@0 14 /**
Chris@0 15 * XPath expression translator interface.
Chris@0 16 *
Chris@0 17 * This component is a port of the Python cssselect library,
Chris@0 18 * which is copyright Ian Bicking, @see https://github.com/SimonSapin/cssselect.
Chris@0 19 *
Chris@0 20 * @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
Chris@0 21 *
Chris@0 22 * @internal
Chris@0 23 */
Chris@0 24 class XPathExpr
Chris@0 25 {
Chris@0 26 private $path;
Chris@0 27 private $element;
Chris@0 28 private $condition;
Chris@0 29
Chris@0 30 /**
Chris@0 31 * @param string $path
Chris@0 32 * @param string $element
Chris@0 33 * @param string $condition
Chris@0 34 * @param bool $starPrefix
Chris@0 35 */
Chris@0 36 public function __construct($path = '', $element = '*', $condition = '', $starPrefix = false)
Chris@0 37 {
Chris@0 38 $this->path = $path;
Chris@0 39 $this->element = $element;
Chris@0 40 $this->condition = $condition;
Chris@0 41
Chris@0 42 if ($starPrefix) {
Chris@0 43 $this->addStarPrefix();
Chris@0 44 }
Chris@0 45 }
Chris@0 46
Chris@0 47 /**
Chris@0 48 * @return string
Chris@0 49 */
Chris@0 50 public function getElement()
Chris@0 51 {
Chris@0 52 return $this->element;
Chris@0 53 }
Chris@0 54
Chris@0 55 /**
Chris@0 56 * @return $this
Chris@0 57 */
Chris@0 58 public function addCondition($condition)
Chris@0 59 {
Chris@14 60 $this->condition = $this->condition ? sprintf('(%s) and (%s)', $this->condition, $condition) : $condition;
Chris@0 61
Chris@0 62 return $this;
Chris@0 63 }
Chris@0 64
Chris@0 65 /**
Chris@0 66 * @return string
Chris@0 67 */
Chris@0 68 public function getCondition()
Chris@0 69 {
Chris@0 70 return $this->condition;
Chris@0 71 }
Chris@0 72
Chris@0 73 /**
Chris@0 74 * @return $this
Chris@0 75 */
Chris@0 76 public function addNameTest()
Chris@0 77 {
Chris@0 78 if ('*' !== $this->element) {
Chris@0 79 $this->addCondition('name() = '.Translator::getXpathLiteral($this->element));
Chris@0 80 $this->element = '*';
Chris@0 81 }
Chris@0 82
Chris@0 83 return $this;
Chris@0 84 }
Chris@0 85
Chris@0 86 /**
Chris@0 87 * @return $this
Chris@0 88 */
Chris@0 89 public function addStarPrefix()
Chris@0 90 {
Chris@0 91 $this->path .= '*/';
Chris@0 92
Chris@0 93 return $this;
Chris@0 94 }
Chris@0 95
Chris@0 96 /**
Chris@0 97 * Joins another XPathExpr with a combiner.
Chris@0 98 *
Chris@0 99 * @param string $combiner
Chris@0 100 * @param XPathExpr $expr
Chris@0 101 *
Chris@0 102 * @return $this
Chris@0 103 */
Chris@14 104 public function join($combiner, self $expr)
Chris@0 105 {
Chris@0 106 $path = $this->__toString().$combiner;
Chris@0 107
Chris@0 108 if ('*/' !== $expr->path) {
Chris@0 109 $path .= $expr->path;
Chris@0 110 }
Chris@0 111
Chris@0 112 $this->path = $path;
Chris@0 113 $this->element = $expr->element;
Chris@0 114 $this->condition = $expr->condition;
Chris@0 115
Chris@0 116 return $this;
Chris@0 117 }
Chris@0 118
Chris@0 119 /**
Chris@0 120 * @return string
Chris@0 121 */
Chris@0 122 public function __toString()
Chris@0 123 {
Chris@0 124 $path = $this->path.$this->element;
Chris@0 125 $condition = null === $this->condition || '' === $this->condition ? '' : '['.$this->condition.']';
Chris@0 126
Chris@0 127 return $path.$condition;
Chris@0 128 }
Chris@0 129 }