singleton method GC.stat_heap

サイズプールごとの GC の統計情報を Hash で返します。

引数を省略すると、すべてのサイズプールの統計情報を、サイズプールの番号をキーとしたハッシュで返します。 heap_id を指定すると、そのサイズプールの統計情報だけを返します。

[PARAM] heap_id:

サイズプールの番号を Integer で指定します。 nil を指定すると、すべてのサイズプールが対象になります。

[PARAM] key:

特定の情報だけを取得したい場合にキーを Symbol で指定します。

[PARAM] result_hash:

戻り値のためのハッシュを指定します。省略した場合は新しくハッシュを作成します。result_hash の内容は上書きされます。

[EXCEPTION] ArgumentError:

存在しないサイズプールの番号を指定した場合に発生します。

# サイズプールごとの統計情報を返す
p GC.stat_heap.keys # => [0, 1, 2, 3, 4]

# サイズプール 0 が扱うオブジェクトの大きさ (バイト)
p GC.stat_heap(0, :slot_size) # => 40

戻り値のハッシュは処理系に依存します。これは将来変更になるかもしれません。

本メソッドは C Ruby 以外では動作しません。

[SEE_ALSO] GC.stat