From 16a9bb3f6f63497946d0efbf403df92d0ce30745 Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Sun, 24 Jan 2021 03:55:18 -0500
Subject: name/number trees: newEmpty, increment/decrement end()

---
 include/qpdf/QPDFNameTreeObjectHelper.hh   | 10 +++++++++-
 include/qpdf/QPDFNumberTreeObjectHelper.hh | 10 +++++++++-
 2 files changed, 18 insertions(+), 2 deletions(-)

(limited to 'include')

diff --git a/include/qpdf/QPDFNameTreeObjectHelper.hh b/include/qpdf/QPDFNameTreeObjectHelper.hh
index 80a48b7f..f0a9b479 100644
--- a/include/qpdf/QPDFNameTreeObjectHelper.hh
+++ b/include/qpdf/QPDFNameTreeObjectHelper.hh
@@ -54,6 +54,12 @@ class QPDFNameTreeObjectHelper: public QPDFObjectHelper
     // structure.
     QPDF_DLL
     QPDFNameTreeObjectHelper(QPDFObjectHandle);
+
+    // Create an empty name tree
+    QPDF_DLL
+    static QPDFNameTreeObjectHelper newEmpty(QPDF&, bool auto_repair = true);
+
+    // ABI: = default
     QPDF_DLL
     virtual ~QPDFNameTreeObjectHelper();
 
@@ -112,7 +118,9 @@ class QPDFNameTreeObjectHelper: public QPDFObjectHelper
     };
 
     // The iterator looks like map iterator, so i.first is a string
-    // and i.second is a QPDFObjectHandle.
+    // and i.second is a QPDFObjectHandle. Incrementing end() brings
+    // you to the first item. Decrementing end() brings you to the
+    // last item.
     QPDF_DLL
     iterator begin() const;
     QPDF_DLL
diff --git a/include/qpdf/QPDFNumberTreeObjectHelper.hh b/include/qpdf/QPDFNumberTreeObjectHelper.hh
index b4f31b12..43c438e4 100644
--- a/include/qpdf/QPDFNumberTreeObjectHelper.hh
+++ b/include/qpdf/QPDFNumberTreeObjectHelper.hh
@@ -51,11 +51,17 @@ class QPDFNumberTreeObjectHelper: public QPDFObjectHelper
     // structure.
     QPDF_DLL
     QPDFNumberTreeObjectHelper(QPDFObjectHandle);
+
+    // ABI: = default
     QPDF_DLL
     virtual ~QPDFNumberTreeObjectHelper()
     {
     }
 
+    // Create an empty number tree
+    QPDF_DLL
+    static QPDFNumberTreeObjectHelper newEmpty(QPDF&, bool auto_repair = true);
+
     typedef long long int numtree_number;
 
     // Return overall minimum and maximum indices
@@ -131,7 +137,9 @@ class QPDFNumberTreeObjectHelper: public QPDFObjectHelper
     };
 
     // The iterator looks like map iterator, so i.first is a string
-    // and i.second is a QPDFObjectHandle.
+    // and i.second is a QPDFObjectHandle. Incrementing end() brings
+    // you to the first item. Decrementing end() brings you to the
+    // last item.
     QPDF_DLL
     iterator begin() const;
     QPDF_DLL
-- 
cgit v1.2.3-54-g00ecf