PHP 8.4.1 Released!

SplObjectStorage::seek

(PHP 8 >= 8.4.0)

SplObjectStorage::seekSeeks iterator to a position

Description

public SplObjectStorage::seek(int $offset): void

Seeks to a given position in the iterator.

Parameters

offset
The position to seek to.

Return Values

No value is returned.

Errors/Exceptions

Throws an OutOfBoundsException if the offset is not seekable.

Examples

Example #1 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());
?>

The above example will output:

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

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top