SplObjectStorage::seek

Seeks iterator to a position

&reftitle.description; public `void` `SplObjectStorage::seek` `int` `offset`

Seeks to a given position in the iterator.

&reftitle.parameters;

`offset`

- The position to seek to.

&reftitle.returnvalues;

&return.void;

&reftitle.errors;

Throws an `OutOfBoundsException` if the `offset` is not seekable.

&reftitle.examples;

### `SplObjectStorage::seek` example

Seeks to item position 2 in the iterator.

    <?php
    class Test {
        public function __construct(public string $marker) {}
    }

    $a = new Test("a");
    $b = new Test("b");
    $c = new Test("c");

    $storage = new SplObjectStorage();
    $storage[$a] = "first";
    $storage[$b] = "second";
    $storage[$c] = "third";

    $storage->seek(2);
    var_dump($storage->key());
    var_dump($storage->current());
    ?>

&example.outputs;

    int(2)
    object(Test)#3 (1) {
      ["marker"]=>
      string(1) "c"
    }

&reftitle.seealso;

- `SeekableIterator`