【Ruby3.x】ObjectSpace::WeakKeyMap::clear()メソッドの使い方
clearメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
clearメソッドは、ObjectSpace::WeakKeyMapインスタンスが保持する全てのキーと値のペアを削除し、マップを空の状態にするメソッドです。
ObjectSpace::WeakKeyMapは、キーへの参照が「弱参照」である特殊なマップ（ハッシュに似たデータ構造）です。通常のハッシュとは異なり、キーとなるオブジェクトが他のどこからも参照されなくなると、Rubyのガベージコレクタによって自動的に解放され、それに伴いWeakKeyMapからも対応するキーと値のペアが削除されるという特徴があります。これにより、不要になったオブジェクトがマップ内に残り続けることを防ぎ、メモリの使用量を最適化するのに役立ちます。
このclearメソッドを呼び出すと、そのような特性を持つWeakKeyMapオブジェクトが現在保持している全てのキーと値のペアが即座に除去されます。結果として、マップは要素を一つも持たない空の状態になります。これは、特定のWeakKeyMapインスタンスの内容を完全にリセットしたい場合や、一時的に格納されたデータを一括で破棄したい場合に非常に便利です。clearメソッドの実行後も、WeakKeyMapインスタンス自体は存続し、引き続き新しいキーと値のペアを追加することができます。
構文(syntax)
1ObjectSpace::WeakKeyMap.new.clear
引数(parameters)
引数なし
引数はありません
戻り値(return)
self
ObjectSpace::WeakKeyMap#clear メソッドは、ハッシュテーブル内の全てのキーと値のペアを削除します。このメソッドは、操作が完了した ObjectSpace::WeakKeyMap インスタンス自身を返します。