Add wrapper for xpath() that always returns an array

README.md

@@ -74,6 +74,14 @@ Returns the first node that matches the given path, or null if none.
 $node = $node->first('d:a/d:b');
 ```
 
+#### all($xpath)
+
+Returns all nodes that matches the given path, or an empty array if none.
+
+```php
+$node = $node->all('d:a/d:b');
+```
+
 #### has($xpath)
 
 Returns true if the node exists, false if not

src/Danmichaelo/QuiteSimpleXMLElement/QuiteSimpleXMLElement.php

@@ -153,7 +153,7 @@ public function el()
 
     /**
      * @param $path
-     * @return array|bool|QuiteSimpleXMLElement[]
+     * @return bool|QuiteSimpleXMLElement[]
      */
     public function xpath($path)
     {
@@ -167,6 +167,18 @@ public function xpath($path)
         return $r2;
     }
 
+    /**
+     * Wrapper method for xpath() that *always* returns an array.
+     *
+     * @param $path
+     * @return QuiteSimpleXMLElement[]
+     */
+    public function all($path)
+    {
+        $r = $this->xpath($path);
+        return (!is_array($r)) ? array() : $r;
+    }
+
     public function __toString()
     {
         return (string) $this->el;

tests/QuiteSimpleXMLElementTest.php

@@ -219,6 +219,20 @@ public function testChildren()
         $this->assertEquals('2013-09-21T18:54:39.718+02:00', $kiddo->text('ns1:DateDue'));
     }
 
+    public function testAll()
+    {
+        $xml = '
+          <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip">
+             <ns1:Test>
+                Hello
+             </ns1:Test>
+          </ns1:NCIPMessage>';
+        $dom = new QuiteSimpleXMLElement($xml);
+
+        $this->assertCount(0, $dom->all('/Test[prop="val"]'));
+        $this->assertCount(1, $dom->all('/ns1:NCIPMessage/ns1:Test'));
+    }
+
     /**
 	 * @expectedException Danmichaelo\QuiteSimpleXMLElement\InvalidXMLException
 	 */