instance method Module#descendants

self を Module#ancestors に持つクラスやモジュールの配列を返します。

self の子孫を返す点で Module#ancestors の逆演算にあたり、x.descendants.include?(y) が成り立つのは y.ancestors.include?(x) が成り立つときに限られます。ただし self 自身、特異クラス、refinement は結果に含まれません。返される配列の順序は不定です。

self は返された子孫への参照を保持しないため、参照を持つオブジェクトが無くなった子孫をガベージコレクションから守ることはありません。そのため、ガベージコレクタが実行されたかどうかによって、一度 descendants に含まれていたクラスやモジュールが結果から消えることがあります。

module A; end
module B; include A; end
class C; include B; end
class D < C; end

p A.descendants # => [B, C, D]
p B.descendants # => [C, D]
p C.descendants # => [D]

[SEE_ALSO] Module#ancestors