annotate vendor/symfony/css-selector/Node/Specificity.php @ 8:50b0d041100e

Further files for download
author Chris Cannam
date Mon, 05 Feb 2018 10:56:40 +0000
parents 4c8ae668cc8c
children 1fec387a4317
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\Node;
Chris@0 13
Chris@0 14 /**
Chris@0 15 * Represents a node specificity.
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 * @see http://www.w3.org/TR/selectors/#specificity
Chris@0 21 *
Chris@0 22 * @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
Chris@0 23 *
Chris@0 24 * @internal
Chris@0 25 */
Chris@0 26 class Specificity
Chris@0 27 {
Chris@0 28 const A_FACTOR = 100;
Chris@0 29 const B_FACTOR = 10;
Chris@0 30 const C_FACTOR = 1;
Chris@0 31
Chris@0 32 /**
Chris@0 33 * @var int
Chris@0 34 */
Chris@0 35 private $a;
Chris@0 36
Chris@0 37 /**
Chris@0 38 * @var int
Chris@0 39 */
Chris@0 40 private $b;
Chris@0 41
Chris@0 42 /**
Chris@0 43 * @var int
Chris@0 44 */
Chris@0 45 private $c;
Chris@0 46
Chris@0 47 /**
Chris@0 48 * Constructor.
Chris@0 49 *
Chris@0 50 * @param int $a
Chris@0 51 * @param int $b
Chris@0 52 * @param int $c
Chris@0 53 */
Chris@0 54 public function __construct($a, $b, $c)
Chris@0 55 {
Chris@0 56 $this->a = $a;
Chris@0 57 $this->b = $b;
Chris@0 58 $this->c = $c;
Chris@0 59 }
Chris@0 60
Chris@0 61 /**
Chris@0 62 * @param Specificity $specificity
Chris@0 63 *
Chris@0 64 * @return self
Chris@0 65 */
Chris@0 66 public function plus(Specificity $specificity)
Chris@0 67 {
Chris@0 68 return new self($this->a + $specificity->a, $this->b + $specificity->b, $this->c + $specificity->c);
Chris@0 69 }
Chris@0 70
Chris@0 71 /**
Chris@0 72 * Returns global specificity value.
Chris@0 73 *
Chris@0 74 * @return int
Chris@0 75 */
Chris@0 76 public function getValue()
Chris@0 77 {
Chris@0 78 return $this->a * self::A_FACTOR + $this->b * self::B_FACTOR + $this->c * self::C_FACTOR;
Chris@0 79 }
Chris@0 80
Chris@0 81 /**
Chris@0 82 * Returns -1 if the object specificity is lower than the argument,
Chris@0 83 * 0 if they are equal, and 1 if the argument is lower.
Chris@0 84 *
Chris@0 85 * @param Specificity $specificity
Chris@0 86 *
Chris@0 87 * @return int
Chris@0 88 */
Chris@0 89 public function compareTo(Specificity $specificity)
Chris@0 90 {
Chris@0 91 if ($this->a !== $specificity->a) {
Chris@0 92 return $this->a > $specificity->a ? 1 : -1;
Chris@0 93 }
Chris@0 94
Chris@0 95 if ($this->b !== $specificity->b) {
Chris@0 96 return $this->b > $specificity->b ? 1 : -1;
Chris@0 97 }
Chris@0 98
Chris@0 99 if ($this->c !== $specificity->c) {
Chris@0 100 return $this->c > $specificity->c ? 1 : -1;
Chris@0 101 }
Chris@0 102
Chris@0 103 return 0;
Chris@0 104 }
Chris@0 105 }