【PHP8.x】offsetGetメソッドの使い方

offsetGetメソッドは、WeakMapオブジェクトから、指定されたキーに関連付けられた値を取得するメソッドです。WeakMapは、キーとしてオブジェクトのみを受け入れる特殊なコレクションであり、そのキーオブジェクトが他の場所から一切参照されなくなった場合に、WeakMapからも自動的にその要素が削除されるという特徴を持っています。この特性により、不要になったオブジェクトがメモリに残り続けることを防ぎ、アプリケーションのメモリ使用効率を高めることができます。

このoffsetGetメソッドは、PHPのArrayAccessインターフェースの実装の一部として提供されており、$weakmap[$key]のように配列の要素にアクセスするような簡潔な構文を用いて、WeakMapに格納されている特定の値を取り出す際に内部的に呼び出されます。値を取得したいキーとなるオブジェクトを引数として渡すと、それに対応する値が戻り値として返されます。もし指定されたキーがWeakMap内に存在しない場合は、UndefinedOffsetExceptionという例外がスローされるため、値を取得する前にはoffsetExistsメソッドなどでキーの存在を確認するか、適切な例外処理を実装することが重要です。このメソッドは、特にオブジェクトの生存期間に関連付けてデータを管理し、メモリフットプリントを最適化したい場合に有用です。

Copy
1<?php
2$weakMap = new WeakMap();
3$keyObject = new stdClass();
4$weakMap[$keyObject] = '関連するデータ';
5$retrievedValue = $weakMap[$keyObject];
6?>

object $object

• object $object: キーとして使用するオブジェクト

mixed

指定されたキーに対応する値、またはキーが存在しない場合は null を返します。