Add C++ iterator API around array and dictionary objects

1 files changed, 14 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index 4b284beb..90177d36 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,19 @@
 2021-01-29  Jay Berkenbilt  <ejb@ql.org>
 
+	* Add wrappers QPDFDictItems and QPDFArrayItems around
+	QPDFObjectHandle that provide a C++ iterator API, including C++11
+	range-for iteration, over arrays and dictionaries. With this, you
+	can do
+
+	for (auto i: QPDFDictItems(oh))
+	{
+	    // i.first is a string, i.second is a QPDFObjectHandle
+	}
+	for (auto i: QPDFArrayItems(oh))
+	{
+	    // i is a QPDFObjectHandle
+	}
+
 	* QPDFObjectHandle::is* methods to check type now return false on
 	uninitialized objects rather than crashing or throwing a logic
 	error.