PHP 8.4.2 Released!

SplObjectStorage::offsetSet

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

SplObjectStorage::offsetSetストレージ内のオブジェクトにデータを関連づける

説明

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

ストレージ内のオブジェクトにデータを関連づけます。

注意:

SplObjectStorage::offsetSet() は、 SplObjectStorage::attach() のエイリアスです。

パラメータ

object

データを関連づけたいオブジェクト。

info

object に関連づけるデータ。

戻り値

値を返しません。

例1 SplObjectStorage::offsetSet() の例

<?php
$s
= new SplObjectStorage;

$o1 = new stdClass;

$s->offsetSet($o1, "hello"); // $s[$o1] = "hello"; と同等

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

上の例の出力は、 たとえば以下のようになります。

string(5) "hello"

参考

add a note

User Contributed Notes 1 note

up
1
aderh
1 year 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...

<?php

declare(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 called
attach called
```

While we would expect...

```
offsetSet called
attach called
attach called
```

... if `offsetSet` was a true alias of `attach`. I'm not sure if this is intentional or not.
To Top