Add removeAllRules() method

Author: JakeQZ

CHANGELOG.md

@@ -12,6 +12,8 @@ Please also have a look at our
 
 - `RuleSet::removeMatchingRules()` method
   (for the implementing classes `AtRuleSet` and `DeclarationBlock`) (#1249)
+- `RuleSet::removeAllRules()` method
+  (for the implementing classes `AtRuleSet` and `DeclarationBlock`) (#1249)
 - Add Interface `CSSElement` (#1231)
 - Methods `getLineNumber` and `getColumnNumber` which return a nullable `int`
   for the following classes:
@@ -50,7 +52,7 @@ Please also have a look at our
 
 - Passing a `string` or `null` to `RuleSet::removeRule()` is deprecated
   (implementing classes are `AtRuleSet` and `DeclarationBlock`);
-  use `removeMatchingRules()` instead (#1249)
+  use `removeMatchingRules()` or `removeAllRules()` instead (#1249)
 - Passing a `Rule` to `RuleSet::getRules()` or `getRulesAssoc()` is deprecated,
   affecting the implementing classes `AtRuleSet` and `DeclarationBlock`
   (call e.g. `getRules($rule->getRule())` instead) (#1248)

src/RuleSet/RuleSet.php

@@ -217,7 +217,7 @@ public function getRulesAssoc($searchPattern = null): array
      * @param Rule|string|null $searchPattern
      *        `Rule` to remove.
      *        Passing a `string` or `null` is deprecated in version 8.9.0, and will no longer work from v9.0.
-     *        Use `removeMatchingRules()` instead.
+     *        Use `removeMatchingRules()` or `removeAllRules()` instead.
      */
     public function removeRule($searchPattern): void
     {
@@ -231,27 +231,30 @@ public function removeRule($searchPattern): void
                     unset($this->rules[$nameOfPropertyToRemove][$key]);
                 }
             }
-        } else {
+        } elseif ($searchPattern !== null) {
             $this->removeMatchingRules($searchPattern);
+        } else {
+            $this->removeAllRules();
         }
     }
 
     /**
      * Removes rules by property name or search pattern.
      *
-     * @param string|null $searchPattern
-     *        pattern to remove. If null, all rules are removed. If the pattern ends in a dash,
+     * @param string $searchPattern
+     *        pattern to remove.
+     *        If the pattern ends in a dash,
      *        all rules starting with the pattern are removed as well as one matching the pattern with the dash
      *        excluded.
      */
-    public function removeMatchingRules(?string $searchPattern): void
+    public function removeMatchingRules(string $searchPattern): void
     {
         foreach ($this->rules as $propertyName => $rules) {
-            // Either no search rule is given or the search rule matches the found rule exactly
+            // Either the search rule matches the found rule exactly
             // or the search rule ends in “-” and the found rule starts with the search rule or equals it
             // (without the trailing dash).
             if (
-                $searchPattern === null || $propertyName === $searchPattern
+                $propertyName === $searchPattern
                 || (\strrpos($searchPattern, '-') === \strlen($searchPattern) - \strlen('-')
                     && (\strpos($propertyName, $searchPattern) === 0
                         || $propertyName === \substr($searchPattern, 0, -1)))
@@ -261,6 +264,11 @@ public function removeMatchingRules(?string $searchPattern): void
         }
     }
 
+    public function removeAllRules(): void
+    {
+        $this->rules = [];
+    }
+
     protected function renderRules(OutputFormat $outputFormat): string
     {
         $result = '';