(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SplObjectStorage::getHash — 中に含むオブジェクトの一意な識別子を算出する
$object): stringこのメソッドは、SplObjectStorage オブジェクトに追加されたオブジェクトの識別子を算出します。
SplObjectStorage の実装では、 spl_object_hash() と同じ値を返します。
ストレージオブジェクトには、同じ識別子のオブジェクトを複数格納することはできません。 それを利用して、セット (一意な値のコレクション) を実装するのにも使えます。 オブジェクトが一意であるという性質は、この関数の返す値が一意であるということで実現できます。
object識別子を算出したいオブジェクト。
算出した識別子を文字列で返します。
返された値が文字列でない場合に RuntimeException をスローします。
例1 SplObjectStorage::getHash() の例
<?php
class OneSpecimenPerClassStorage extends SplObjectStorage {
public function getHash($o) {
return get_class($o);
}
}
class A {}
$s = new OneSpecimenPerClassStorage;
$o1 = new stdClass;
$o2 = new stdClass;
$o3 = new A;
$s[$o1] = 1;
// $o2 は $o1 に等しいとみなされ、値が置き換えられます
$s[$o2] = 2;
$s[$o3] = 3;
// これらは先ほどのオブジェクトと等しいとみなされ、
// さきほど格納した値にアクセスできるようになります
$p1 = new stdClass;
$p2 = new A;
echo $s[$p1], "\n";
echo $s[$p2], "\n";
?>
上の例の出力は、 たとえば以下のようになります。
2 3