Fix PHP 8.1 compatibility

Author: thekid

ChangeLog.md

@@ -3,6 +3,12 @@ Tokenize log
 
 ## ?.?.? / ????-??-??
 
+## 9.0.2 / 2021-08-16
+
+* Fixed PHP 8.1 compatibility by declaring `getIterator()` with correct
+  return type. See https://wiki.php.net/rfc/internal_method_return_types
+  (@thekid)
+
 ## 9.0.1 / 2020-10-09
 
 * Fixed reading past end to consistently return `NULL` - @thekid

src/main/php/text/Tokenizer.class.php

@@ -1,12 +1,15 @@
 <?php namespace text;
+
+use Traversable, IteratorAggregate;
+
 /**
  * A tokenizer splits input strings into tokens.
  * 
  * @see    xp://text.StringTokenizer
  * @see    xp://text.StreamTokenizer
  * @see    php://strtok
  */
-abstract class Tokenizer implements \IteratorAggregate {
+abstract class Tokenizer implements IteratorAggregate {
   public $delimiters;
   public $returnDelims;
   protected $source;
@@ -25,13 +28,8 @@ public function __construct($source, $delimiters= ' ', $returnDelims= false) {
     $this->reset();
   }
 
-  /**
-   * Returns an iterator for use in foreach()
-   *
-   * @see     php://language.oop5.iterations
-   * @return  php.Iterator
-   */
-  public function getIterator() {
+  /** Returns an iterator for use in foreach() */
+  public function getIterator(): Traversable {
     while ($this->hasMoreTokens()) {
       yield $this->nextToken();
     }