Convenience method to collect a vector from StockpileIterator.

library/include/modules/Buildings.h

@@ -284,5 +284,10 @@ public:
     }
 };
 
+/**
+ * Collects items stored on a stockpile into a vector.
+ */
+DFHACK_EXPORT void getStockpileContents(df::building_stockpilest *stockpile, std::vector<df::item*> *items);
+
 }
 }

library/modules/Buildings.cpp

@@ -1163,3 +1163,16 @@ void Buildings::updateBuildings(color_ostream& out, void* ptr)
         corner2.erase(id);
     }
 }
+
+void Buildings::getStockpileContents(df::building_stockpilest *stockpile, std::vector<df::item*> *items)
+{
+    CHECK_NULL_POINTER(stockpile);
+
+    items->clear();
+
+    Buildings::StockpileIterator stored;
+    for (stored.begin(stockpile); !stored.done(); ++stored) {
+        df::item *item = *stored;
+        items->push_back(item);
+    }
+}