【Ruby3.x】ObjectSpace::WeakMap::length()メソッドの使い方

lengthメソッドはObjectSpace::WeakMapオブジェクトに現在保持されているキーと値のペアの数を取得するメソッドです。

ObjectSpace::WeakMapは、キーとして登録されたオブジェクトへの「弱い参照」を持つ特殊なマップ（連想配列のようなもの）です。通常のマップでは、キーとしてオブジェクトを登録すると、そのオブジェクトへの参照が内部に保持されるため、たとえ他の場所からそのオブジェクトが参照されなくなっても、ガーベージコレクションによって解放されずメモリに残ってしまいます。しかし、ObjectSpace::WeakMapの場合、キーとして登録されたオブジェクトが他のどこからも参照されなくなり、Rubyのガーベージコレクションが実行されると、そのキーとそれに対応する値がWeakMapから自動的に削除されます。これにより、不要になったオブジェクトがメモリを占有し続けることを防ぎ、メモリ効率の良いアプリケーション開発に貢献します。

このlengthメソッドは、特定のWeakMapインスタンスが、現在どれだけのキーと値のペアを「弱い参照」として追跡しているかを示す整数値を返します。ただし、WeakMapの特性上、ガーベージコレクションの実行タイミングによって内部の要素数が自動的に変動する可能性があるため、lengthメソッドが返す値は、その時点での状態を示すスナップショットとして解釈する必要があります。これにより、アプリケーションのメモリ使用状況やWeakMapの管理状態を把握するのに役立ちます。

Copy
1require 'objspace'
2
3weak_map = ObjectSpace::WeakMap.new
4weak_map[:key1] = "value1"
5weak_map[:key2] = "value2"
6weak_map.length # => 2

引数なし

引数はありません

Integer

ObjectSpace::WeakMap オブジェクトに格納されているキーと値のペアの数を整数で返します。