adding a familiar forEach() function that you can use to drain any iterator, like you can do with an array.
documenting forEach()
Merge branch 'dev'
bumping the version number to 1.0.0 because this code is now live in production code, and now it also provides a new forEach() function.