Made some changes to iterator (brought it closer to the es6 iterator and php iterator specs).
Updated readme to reflect latest changes.  Merged `sjl.Iterator` update.