所以我不确定这是否是 PHP 的错误设计，或者是否存在处理同一界面的不一致结果的可理解逻辑。

SeekableIterator 接口(interface)有两个方法(seek 和 valid)，它们要么相互冲突，要么应该一致地工作，但我看到两者。

接口(interface)文档说 seek 应该抛出类 OutOfBoundsException 的异常，但这似乎否定了 valid 的用处，除非更新迭代器位置(使valid 在抛出异常(显然必须捕获)之前返回 false)。

三个测试例子

例子1.

实现 SeekableIterator 的自定义类，如文档中的示例所提供的:

类(class):

class MySeekableIterator implements SeekableIterator {

    private $position;

    private $array = array(
        "first element",
        "second element",
        "third element",
        "fourth element"
    );

    /* Method required for SeekableIterator interface */

    public function seek($position) {
        if (!isset($this->array[$position])) {
            throw new OutOfBoundsException("invalid seek position ($position)");
        }

        $this->position = $position;
    }

    /* Methods required for Iterator interface */

    public function rewind() {
        $this->position = 0;
    }

    public function current() {
        return $this->array[$this->position];
    }

    public function key() {
        return $this->position;
    }

    public function next() {
        ++$this->position;
    }

    public function valid() {
        return isset($this->array[$this->position]);
    }
}

示例 1. 测试:

echo PHP_EOL . "Custom Seekable Iterator seek Test" . PHP_EOL;

$it = new MySeekableIterator;

$it->seek(1);
try {
    $it->seek(10);
    echo $it->key() . PHP_EOL;
    echo "Is valid? " . (int) $it->valid() . PHP_EOL;
} catch (OutOfBoundsException $e) {
    echo $e->getMessage() . PHP_EOL;
    echo $it->key() . PHP_EOL; // outputs previous position (1)
    echo "Is valid? " . (int) $it->valid() . PHP_EOL;
}

测试 1 输出:

Custom Seekable Iterator seek Test
invalid seek position (10)
1
Is valid? 1

例子2:

使用原生 ArrayIterator::seek

测试2代码:

echo PHP_EOL . "Array Object Iterator seek Test" . PHP_EOL;

$array = array('1' => 'one',
               '2' => 'two',
               '3' => 'three');

$arrayobject = new ArrayObject($array);
$iterator = $arrayobject->getIterator();

$iterator->seek(1);
try {
    $iterator->seek(5);
    echo $iterator->key() . PHP_EOL;
    echo "Is valid? " . (int) $iterator->valid() . PHP_EOL;
} catch (OutOfBoundsException $e) {
    echo $e->getMessage() . PHP_EOL;
    echo $iterator->key() . PHP_EOL;  // outputs previous position (1)
    echo "Is valid? " . (int) $iterator->valid() . PHP_EOL;
}

测试 2 输出:

Array Object Iterator seek Test
Seek position 5 is out of range
1
Is valid? 1

示例 3:

使用 native DirectoryIterator::seek

测试 3 代码:

echo PHP_EOL . "Directory Iterator seek Test" . PHP_EOL;

$dir_iterator = new DirectoryIterator(dirname(__FILE__));
$dir_iterator->seek(1);
try {
    $dir_iterator->seek(500);  // arbitrarily high seek position
    echo $dir_iterator->key() . PHP_EOL;
    echo "Is valid? " . (int) $dir_iterator->valid() . PHP_EOL;
} catch (OutOfBoundsException $e) {
    echo $e->getMessage() . PHP_EOL;
    echo $dir_iterator->key() . PHP_EOL;
    echo "Is valid? " . (int) $dir_iterator->valid() . PHP_EOL;
}

测试 3 输出:

Directory Iterator seek Test
90
Is valid? 0

那么人们如何合理地期望知道是否使用 valid() 来确认 seek($position) 之后的有效位置，同时还预计 seek () 可能会抛出异常而不是更新位置，以便 valid() 返回 true？

最佳答案

似乎 directoryIterator::seek()这里的方法没有异常实现。相反，它不会返回任何值，并让 valid()处理它。

你的另一个例子，ArrayObject::seek()确实“正确”工作并抛出 OutOfBoundsException .

推理很简单:ArrayObject (很可能，大多数自定义实现也是如此)会事先知道它包含多少元素，因此可以快速检查它的边界。 DirectoryIterator但是，必须从磁盘中逐个读取目录实体才能到达给定位置。它通过字面上调用 valid() 来实现和 next()在一个循环中。这就是为什么 key()已经改变，并且valid()返回 0 .

其他迭代器甚至不会触及当前迭代器状态，并且可以快速判断您的请求是否在其范围内。

旁注:如果您想在 DirectoryIterator 中向后查找位置，它将首先重置迭代器，然后再次开始迭代每个元素。所以如果你在位置 1000，做 $it->seek(999) ，它实际上会再次迭代 999 个元素。

恕我直言，DirectoryIterator不是 seekableIterator 的良好实现界面。它旨在快速跳转到迭代器中的某个元素，显然，使用 directoryIterator 这不是可行的。相反，必须进行完整的迭代，这会导致迭代器状态发生变化。

seekableIterator interface 对于 filterIterators 很有用，它对迭代器的范围做一些事情。在 SPL 中，这只是 LimitIterator .当你这样做时:

$it = new ArrayIterator(range('a','z'));
$it = new LimitIterator($it, 5, 10));

当 limitIterator 检测到给定的迭代器已经实现了 seekableIterator接口(interface)，它会调用seek()快速跳转到第 5 个元素，否则它只会迭代直到到达第 5 个元素。

结论:不要使用 seekableIterator当您无法快速跳到某个位置或检查边界时。最好的情况是您什么也得不到，最坏的情况是您会得到不知道为什么会改变状态的迭代器。

回答您的问题:seek()应该抛出异常而不改变状态。 directoryIterator (也许还有其他人)应该改为不实现 seekableIterator ，或找出 seek() 之前有多少条目(但这并不能解决向后搜索问题时的“倒带”)。

关于PHP 可搜索迭代器 : catch OutOfBoundsException or check valid() method?，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/30398762/