Add `BaseHandle::get` method for simplified access to object handles by key

m-holger
1 parent 65ef82be
Showing 2 changed files with 16 additions and 0 deletions
include/qpdf/ObjectHandle.hh
libqpdf/qpdf/QPDFObjectHandle_private.hh
@@ -137,6 +137,8 @@ namespace qpdf
  
         std::string description() const;
  
+        inline QPDFObjectHandle const& get(std::string const& key) const;
+
         void no_ci_warn_if(bool condition, std::string const& warning) const;
         void no_ci_stop_if(bool condition, std::string const& warning) const;
         void no_ci_stop_damaged_if(bool condition, std::string const& warning) const;
@@ -806,6 +806,20 @@ namespace qpdf
         }
     }
  
+    /// @brief Retrieves the QPDFObjectHandle const& associated with the given key.
+    ///
+    /// This method provides a convenience alternative to the direct use of the subscript operator
+    /// "(*this)[key]" or "oh()[key]" in derived classes, enabling a simplified and readable way to
+    /// access object handles by key.
+    ///
+    /// @param key The string key used to look up the corresponding QPDFObjectHandle.
+    /// @return A constant reference to the QPDFObjectHandle associated with the specified key.
+    inline QPDFObjectHandle const&
+    BaseHandle::get(std::string const& key) const
+    {
+        return (*this)[key];
+    }
+
     inline bool
     BaseHandle::null() const
     {