Description:
------------
Originally reported on SO: http://stackoverflow.com/q/30398762/2908724

DirecotryIterator implements SeekableIterator, which "should throw an OutOfBoundsException if the position is not seekable".  However, the DirectoryIterator implementation simply returns when the position cannot be sought.

This leads to developer confusion, like:

So how would one reasonably expect to know whether to use valid() to confirm valid position after seek($position) while also anticipating that the seek() might throw an Exception instead of updating the position, so that valid() returns true?


Related to https://bugs.php.net/bug.php?id=32130

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


Expected result:
----------------
Seek position 500 is out of range
90
Is valid? 0


Actual result:
--------------
90
Is valid? 0