as noted in CHANGES.md

Author: tyler-gilbert

CHANGES.md

@@ -2,6 +2,7 @@
 
 ## New Features
 
+- Add an iterator for `JsonArray` to support range-for loops
 - Add an iterator for `JsonObject` to support range-for loops
 - Add `find()` to `JsonValue` to find a sub-value based on a path e.g "top/[4]/next"
 - Add method `native_value()` to `JsonValue` which can be used for object tracing and debugging.

library/include/json/Json.hpp

@@ -150,6 +150,7 @@ class JsonValue : public api::ExecutionContext {
 private:
   friend class JsonDocument;
   friend class JsonObjectIterator;
+  friend class JsonArrayIterator;
   friend class JsonObject;
   friend class JsonArray;
   friend class JsonTrue;
@@ -219,7 +220,7 @@ class JsonObjectIterator : private JsonApi {
     return m_json_iter != a.m_json_iter;
   }
 
-  JsonObject operator*() const noexcept;
+  JsonValue operator*() const noexcept;
 
   JsonObjectIterator &operator++() {
     m_json_iter = api()->object_iter_next(m_json_value, m_json_iter);
@@ -306,19 +307,66 @@ class JsonObject : public JsonValue {
   JsonObject &clear();
 
   JsonValue at(const var::StringView key) const;
+  JsonValue at(size_t offset) const;
 
   KeyList get_key_list() const;
 
 private:
   json_t *create() override;
 };
 
+class JsonArrayIterator : private JsonApi {
+public:
+
+  JsonArrayIterator() = default;
+
+  JsonArrayIterator(json_t * value, size_t index){
+    m_json_value = value;
+    m_index = index;
+  }
+
+
+  bool operator!=(JsonArrayIterator const &a) const noexcept {
+    return m_index != a.m_index;
+  }
+
+  JsonValue operator*() const noexcept {
+    return api()->array_get(m_json_value, m_index);
+  }
+
+  JsonArrayIterator &operator++() {
+    m_index++;
+    return *this;
+  }
+
+
+private:
+  json_t * m_json_value = nullptr;
+  size_t m_index = 0;
+};
+
 class JsonArray : public JsonValue {
 public:
   JsonArray();
   JsonArray(const JsonArray &value);
   JsonArray &operator=(const JsonArray &value);
 
+  JsonArrayIterator begin() const noexcept {
+    return JsonArrayIterator(m_value, 0);
+  }
+
+  JsonArrayIterator end() const noexcept {
+    return JsonArrayIterator(m_value, count());
+  }
+
+  JsonArrayIterator cbegin() const noexcept {
+    return JsonArrayIterator(m_value, 0);
+  }
+
+  JsonArrayIterator cend() const noexcept {
+    return JsonArrayIterator(m_value, count());
+  }
+
   explicit JsonArray(const var::StringList &list);
   explicit JsonArray(const var::StringViewList &list);
   explicit JsonArray(const var::Vector<float> &list);

library/src/Json.cpp

@@ -192,7 +192,7 @@ const JsonObject &JsonValue::to_object() const {
   return static_cast<const JsonObject &>(*this);
 }
 
-JsonObject JsonObjectIterator::operator*() const noexcept {
+JsonValue JsonObjectIterator::operator *() const noexcept {
   return JsonValue(m_json_value)
     .to_object()
     .at(api()->object_iter_key(m_json_iter));
@@ -493,6 +493,17 @@ JsonValue JsonObject::at(const var::StringView key) const {
   return JsonValue(api()->object_get(m_value, Key(key).cstring));
 }
 
+JsonValue JsonObject::at(size_t offset) const {
+  size_t count = 0;
+  for(const auto & child: *this){
+    if( count == offset ){
+      return child;
+    }
+    count++;
+  }
+  return JsonValue();
+}
+
 JsonValue
 JsonValue::find(const var::StringView path, const char *delimiter) const {
   const auto list = path.split(delimiter);