L05DOCBST-38 add get_next_ofs method

src/library/Webquery.php

@@ -345,7 +345,7 @@ class Webquery {
 
     /**
      * return value of the hits element in search response
-     * @return number of hits or false if there is no valid search reponse
+     * @return number of hits or false if there is no valid search response
      */
     public function get_hits() {
 
@@ -374,6 +374,26 @@ class Webquery {
     }
 
 
+    /**
+     * return value of wq_ofs attribute of next element in search response
+     * @return value of next wq_ofs or false if there is no valid search response
+     */
+    public function get_next_ofs() {
+
+        $resp_xml = $this->get_resp_xml();
+        if (!isset($resp_xml)) {
+            return false;
+        }
+
+        $next = $resp_xml->xpath("//next");
+        if (empty($next)) {
+            return false;
+        }
+        $attr = $next[0]->attributes();
+        return empty($attr['wq_ofs']) ? false : (string) $attr['wq_ofs'];
+    }
+
+
 /**
  * convert xml tree to x-www-form-urlencoded string
  * @param SimpleXMLElement $xml  xml tree

tests/library/WebqueryTest.php

@@ -143,6 +143,7 @@ EOT;
         $this->assertEquals('', $wq->get_error_message(), '1st: search response error message');
         $this->assertEquals(1, $wq->get_hits(), '1st: search response hits');
         $this->assertTrue($wq->has_next(), '1st: search response has next element');
+        $this->assertEquals(1, $wq->get_next_ofs(), '1st: search response next wq_ofs');
 
         // second request fails
         $wq->set_query('record=nothing');
@@ -164,6 +165,7 @@ EOT;
         $this->assertEquals('nothing found', $wq->get_error_message(), '2nd: search response error message');
         $this->assertEquals(false, $wq->get_hits(), '2nd: search response hits');
         $this->assertFalse($wq->has_next(), '1st: search response has next element');
+        $this->assertEquals(false, $wq->get_next_ofs(), '2nd: search response next wq_ofs');
 
         $this->assertEquals(2, count($request_history), 'request history count');
         // check first request