Change `Iter` to be general iterator class

Previously `Iter` was meant to be a collection iterator class, but now
we need a more generalized notion of iterator, so we move some
collection-specific methods out and designate `Iter` a general iterator
class, while `CollectionIterator` takes its former place.

sources/Commands/Commands_Feature.uc

@@ -266,7 +266,7 @@ public final function RegisterCommand(class<Command> commandClass)
 public final function RemoveCommand(class<Command> commandClass)
 {
     local int                   i;
-    local Iter          iter;
+    local CollectionIterator    iter;
     local Command               nextCommand;
     local Text                  nextCommandName;
     local array<Text>           commandGroup;          

sources/CoreRealm/Iter.uc

@@ -0,0 +1,66 @@
+/**
+ *      Base class for iterator, an auxiliary object for iterating through
+ *  a set of objects obtained from some context-dependent source.
+ *      Copyright 2022 Anton Tarasenko
+ *------------------------------------------------------------------------------
+ * This file is part of Acedia.
+ *
+ * Acedia is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Acedia is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
+ */
+class Iter extends AcediaObject
+    abstract;
+
+/**
+ *      Makes iterator pick next item.
+ *  Use `HasFinished()` to check whether you have iterated all of them.
+ *
+ *  @param  skipNone    @deprecated
+ *      Set this to `true` if you want to skip all stored
+ *      values that are equal to `none`. By default does not skip them.
+ *      Since order of iterating through items is not guaranteed, at each
+ *      `Next()` call an arbitrary set of items can be skipped.
+ *  @return Reference to caller `Iterator` to allow for method chaining.
+ */
+public function Iter Next(optional bool skipNone);
+
+/**
+ *  Returns current value pointed to by an iterator.
+ *
+ *  Does not advance iteration: use `Next()` to pick next value.
+ *
+ *  @return Current value being iterated over. If `Iterator()` has finished
+ *      iterating over all values or was not initialized - returns `none`.
+ *      Note that depending on context `none` values can also be returned,
+ *      use `LeaveOnlyNotNone()` method to prevent that.
+ */
+public function AcediaObject Get();
+
+/**
+ *  Checks if caller `Iterator` has finished iterating.
+ *
+ *  @return `true` if caller `Iterator` has finished iterating or
+ *      was not initialized. `false` otherwise.
+ */
+public function bool HasFinished();
+
+/**
+ *  Makes caller iterator skip any `none` items during iteration.
+ *
+ *  @return Reference to caller `Iterator` to allow for method chaining.
+ */
+public function Iter LeaveOnlyNotNone();
+
+defaultproperties
+{
+}

sources/Data/Collections/ArrayListIterator.uc

@@ -17,7 +17,7 @@
  * You should have received a copy of the GNU General Public License
  * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
  */
-class ArrayListIterator extends Iter
+class ArrayListIterator extends CollectionIterator
     dependson(ArrayList);
 
 var private ArrayList   relevantCollection;

sources/Data/Collections/AssociativeArrayIterator.uc

@@ -17,7 +17,7 @@
  * You should have received a copy of the GNU General Public License
  * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
  */
-class AssociativeArrayIterator extends Iter
+class AssociativeArrayIterator extends CollectionIterator
     dependson(AssociativeArray);
 
 var private bool                    hasNotFinished;

sources/Data/Collections/Collection.uc

@@ -22,7 +22,7 @@
 class Collection extends AcediaObject
     abstract;
 
-var protected class<Iter> iteratorClass;
+var protected class<CollectionIterator> iteratorClass;
 
 /**
  *  Method that must be overloaded for `GetItemByPointer()` to properly work.
@@ -46,10 +46,11 @@ protected function AcediaObject GetByText(BaseText key);
  *  @return New initialized `Iterator` that will iterate over all items in
  *      a given collection. Guaranteed to be not `none`.
  */
-public final function Iter Iterate()
+public final function CollectionIterator Iterate()
 {
-    local Iter newIterator;
+    local CollectionIterator newIterator;
-    newIterator = Iter(_.memory.Allocate(iteratorClass));
+
+    newIterator = CollectionIterator(_.memory.Allocate(iteratorClass));
     if (!newIterator.Initialize(self))
     {
         //  This should not ever happen.

sources/Data/Collections/CollectionIterator.uc

@@ -1,9 +1,9 @@
 /**
- *      Base class for iterator, an auxiliary object for iterating through
+ *      Base class for collection iterators, an auxiliary object for iterating
- *  objects stored inside an Acedia's collection.
+ *  through objects stored inside an Acedia's collection.
  *      Iterators expect that collection remains unchanged while they
  *  are iterating through it. Otherwise their behavior becomes undefined.
- *      Copyright 2020 Anton Tarasenko
+ *      Copyright 2020-2022 Anton Tarasenko
  *------------------------------------------------------------------------------
  * This file is part of Acedia.
  *
@@ -20,7 +20,7 @@
  * You should have received a copy of the GNU General Public License
  * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
  */
-class Iter extends AcediaObject
+class CollectionIterator extends Iter
     abstract;
 
 /**
@@ -40,33 +40,6 @@ class Iter extends AcediaObject
  */
 public function bool Initialize(Collection relevantCollection);
 
-/**
- *      Makes iterator pick next item in collection.
- *      As long as collection that's being iterated over is not modified,
- *  `Next()` is guaranteed to iterate over all it's items.
- *  Use `HasFinished()` to check whether you have iterated all of them.
- *      Order of iteration is not guaranteed.
- *
- *  @param  skipNone    Set this to `true` if you want to skip all stored
- *      values that are equal to `none`. By default does not skip them.
- *      Since order of iterating through items is not guaranteed, at each
- *      `Next()` call an arbitrary set of items can be skipped.
- *  @return Reference to caller `Iterator` to allow for method chaining.
- */
-public function Iter Next(optional bool skipNone);
-
-/**
- *  Returns current value pointed to by an iterator.
- *
- *  Does not advance iteration: use `Next()` to pick next value.
- *
- *  @return Current value being iterated over. If `Iterator()` has finished
- *      iterating over all values or was not initialized - returns `none`.
- *      Note that `none` can also be returned if it's stored in a collection,
- *      use `LeaveOnlyNotNone()` method to prevent that.
- */
-public function AcediaObject Get();
-
 /**
  *  Returns key of current value pointed to by an iterator.
  *
@@ -83,21 +56,6 @@ public function AcediaObject Get();
  */
 public function AcediaObject GetKey();
 
-/**
- *  Checks if caller `Iterator` has finished iterating.
- *
- *  @return `true` if caller `Iterator` has finished iterating or
- *      was not initialized. `false` otherwise.
- */
-public function bool HasFinished();
-
-/**
- *  Makes caller iterator skip any `none` items during iteration.
- *
- *  @return Reference to caller `Iterator` to allow for method chaining.
- */
-public function Iter LeaveOnlyNotNone();
-
 defaultproperties
 {
 }

sources/Data/Collections/DynamicArrayIterator.uc

@@ -17,7 +17,7 @@
  * You should have received a copy of the GNU General Public License
  * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
  */
-class DynamicArrayIterator extends Iter;
+class DynamicArrayIterator extends CollectionIterator;
 
 var private DynamicArray    relevantCollection;
 var private int             currentIndex;

sources/Data/Collections/HashTableIterator.uc

@@ -17,7 +17,7 @@
  * You should have received a copy of the GNU General Public License
  * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
  */
-class HashTableIterator extends Iter
+class HashTableIterator extends CollectionIterator
     dependson(HashTable);
 
 var private bool            hasNotFinished;

sources/Data/Collections/Tests/TEST_Iterator.uc

@@ -43,7 +43,7 @@ protected static function ResetFlags()
 protected static function DoTestIterator(
     string              issueSubjectAllocation,
     string              issueSubjectAmount,
-    Iter    iter)
+    CollectionIterator  iter)
 {
     local int           i;
     local int           seenCount;
@@ -93,7 +93,7 @@ protected static function TESTS()
 protected static function Test_ArrayList()
 {
     local int                   i;
-    local Iter      iter;
+    local CollectionIterator    iter;
     local ArrayList             array;
 
     array = ArrayList(__().memory.Allocate(class'ArrayList'));
@@ -127,7 +127,7 @@ protected static function Test_ArrayList()
 protected static function Test_HashTable()
 {
     local int                   i;
-    local Iter      iter;
+    local CollectionIterator    iter;
     local HashTable             array;
 
     array = HashTable(__().memory.Allocate(class'HashTable'));
@@ -168,7 +168,7 @@ protected static function SubTest_ArrayListIterationAndNone()
 {
     local bool                  sawNone;
     local int                   counter;
-    local Iter      iter;
+    local CollectionIterator    iter;
     local ArrayList             list;
 
     list = __().collections.EmptyArrayList();
@@ -192,7 +192,8 @@ protected static function SubTest_ArrayListIterationAndNone()
         @ "`LeaveOnlyNotNone()` call.");
     sawNone = false;
     counter = 0;
-    iter = list.Iterate().LeaveOnlyNotNone();
+    iter = list.Iterate();
+    iter.LeaveOnlyNotNone();
     while (!iter.HasFinished())
     {
         sawNone = sawNone || (iter.Get() == none);
@@ -207,7 +208,7 @@ protected static function SubTest_HashTableIterationAndNone()
 {
     local bool                  sawNone;
     local int                   counter;
-    local Iter      iter;
+    local CollectionIterator    iter;
     local HashTable             table;
 
     table = __().collections.EmptyHashTable();
@@ -231,7 +232,8 @@ protected static function SubTest_HashTableIterationAndNone()
         @ "`LeaveOnlyNotNone()` call.");
     sawNone = false;
     counter = 0;
-    iter = table.Iterate().LeaveOnlyNotNone();
+    iter = table.Iterate();
+    iter.LeaveOnlyNotNone();
     while (!iter.HasFinished())
     {
         sawNone = sawNone || (iter.Get() == none);

sources/Data/Collections/Tests/TEST_IteratorOld.uc

@@ -76,8 +76,9 @@ protected static function TESTS()
 protected static function Test_DynamicArray()
 {
     local int                   i;
-    local Iter          iter;
+    local CollectionIterator    iter;
     local DynamicArray          array;
+
     array = DynamicArray(__().memory.Allocate(class'DynamicArray'));
     iter = array.Iterate();
     Context("Testing iterator for `DynamicArray`");
@@ -106,7 +107,7 @@ protected static function Test_DynamicArray()
 protected static function Test_AssociativeArray()
 {
     local int                   i;
-    local Iter              iter;
+    local CollectionIterator    iter;
     local AssociativeArray      array;
     array = AssociativeArray(__().memory.Allocate(class'AssociativeArray'));
     iter = array.Iterate();

sources/Data/Database/Local/DBRecord.uc

@@ -923,7 +923,7 @@ private final function FromArrayList(ArrayList source)
 private final function FromHashTable(HashTable source)
 {
     local int                   i, originalStorageLength;
-    local Iter          iter;
+    local CollectionIterator    iter;
     local string                nextKey;
     local bool                  isNewKey;
     local AcediaObject          nextObject;

sources/Gameplay/BaseClasses/Frontend/World/AWorldComponent.uc

@@ -0,0 +1,26 @@
+/**
+ *  Subset of functionality for dealing with basic game world interactions:
+ *  searching for entities, tracing, etc..
+ *      Copyright 2022 Anton Tarasenko
+ *------------------------------------------------------------------------------
+ * This file is part of Acedia.
+ *
+ * Acedia is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Acedia is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
+ */
+class AWorldComponent extends AcediaObject
+    abstract;
+
+defaultproperties
+{
+}

sources/Text/JSON/JSONAPI.uc

@@ -1227,7 +1227,7 @@ public final function MutableText PrintArrayList(ArrayList toPrint)
 public final function MutableText PrintObject(AssociativeArray toPrint)
 {
     local bool                  printedKeyValuePair;
-    local Iter          iter;
+    local CollectionIterator    iter;
     local Text                  nextKey;
     local AcediaObject          nextValue;
     local MutableText           result, printedKey, printedValue;
@@ -1286,7 +1286,7 @@ public final function MutableText PrintObject(AssociativeArray toPrint)
 public final function MutableText PrintHashTable(HashTable toPrint)
 {
     local bool                  printedKeyValuePair;
-    local Iter          iter;
+    local CollectionIterator    iter;
     local Text                  nextKey;
     local AcediaObject          nextValue;
     local MutableText           result, printedKey, printedValue;
@@ -1651,7 +1651,7 @@ private final function MutableText PrettyPrintObjectWithIndent(
     MutableText         accumulatedIndent)
 {
     local bool                  printedKeyValuePair;
-    local Iter          iter;
+    local CollectionIterator    iter;
     local Text                  nextKey;
     local AcediaObject          nextValue;
     local MutableText           extendedIndent;
@@ -1694,7 +1694,7 @@ private final function MutableText PrettyPrintHashTableWithIndent(
     MutableText accumulatedIndent)
 {
     local bool                  printedKeyValuePair;
-    local Iter          iter;
+    local CollectionIterator    iter;
     local Text                  nextKey;
     local AcediaObject          nextValue;
     local MutableText           extendedIndent;