New function to return page ID

VERSION

@@ -1 +1 @@
-4.0.11
+4.1.0

src/Region.php

@@ -206,6 +206,7 @@ public function getPage(int $pid = -1): array
         return $this->page[$pid];
     }
 
+
     /**
      * Check if the specified page ID exist.
      *

src/Settings.php

@@ -115,6 +115,16 @@ abstract class Settings extends \Com\Tecnick\Pdf\Page\Box
      */
     protected int $rootoid = 0;
 
+    /**
+     * Return the current page ID.
+     *
+     * @return int Page ID.
+     */
+    public function getPageID(): int
+    {
+        return $this->pid;
+    }
+
     /**
      * Sanitize or set the page modification time.
      *

test/PageTest.php

@@ -183,6 +183,9 @@ public function testAdd(): void
             ],
         ];
         $this->bcAssertEqualsWithDelta($exp, $res);
+
+        $pid = $page->getPageID();
+        $this->assertEquals(3, $pid);
     }
 
     public function testGetNextPage(): void

test/RegionTest.php

@@ -135,5 +135,8 @@ public function testRegionBoundaries(): void
         $this->assertFalse($res);
         $res = $page->isXOutRegion(141);
         $this->assertTrue($res);
+
+        $pid = $page->getPageID();
+        $this->assertEquals(0, $pid);
     }
 }

test/SettingsTest.php

@@ -36,6 +36,14 @@ protected function getTestObject(): \Com\Tecnick\Pdf\Page\Page
         return new \Com\Tecnick\Pdf\Page\Page('mm', $pdf, $encrypt, false, false);
     }
 
+    public function testGetPageID(): void
+    {
+        $page = $this->getTestObject();
+
+        $pid = $page->getPageID();
+        $this->assertEquals(-1, $pid);
+    }
+
     public function testSanitizePageNumber(): void
     {
         $page = $this->getTestObject();