SplObjectStorage::offsetSet

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

SplObjectStorage::offsetSet — Associates data to an object in the storage

Description

public SplObjectStorage::offsetSet(object $object, mixed $info = null): void

Associate data to an object in the storage.

Note:
SplObjectStorage::offsetSet() is an alias of SplObjectStorage::attach().

Parameters

object: The object to associate data with.
info: The data to associate with the object.

Return Values

No value is returned.

Examples

Example #1 SplObjectStorage::offsetSet() example

<?php
$s = new SplObjectStorage;

$o1 = new stdClass;

$s->offsetSet($o1, "hello"); // Similar to $s[$o1] = "hello";

var_dump($s[$o1]);
?>

The above example will output something similar to:

string(5) "hello"

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

aderh ¶

2 years ago

Although `offsetSet` is supposed to be an alias to `attach`, real-world results do not indicate that. When extending the SplObjectStorage class, it's expected that a modification to `attach` would also affect `offsetSet`. However, it seems they need to both be extended. Consider the results below...<?phpdeclare(strict_types=1);class CustomSplObjectStorage extends SplObjectStorage{    public function offsetSet(mixed $object, mixed $info = null): void    {        print("offsetSet called\n");        parent::offsetSet($object, $info);    }    public function attach(mixed $object, mixed $info = null): void    {        print("attach called\n");        parent::attach($object, $info);    }}$a = new CustomSplObjectStorage();$a[new stdClass()] = 'ok';$a->attach(new stdClass(), 'ok');?>This prints:```offsetSet calledattach called```While we would expect...```offsetSet calledattach calledattach called```... if `offsetSet` was a true alias of `attach`. I'm not sure if this is intentional or not.