instance method Module#autoload_relative

定数 const_name を最初に参照した時に、feature を呼び出し元のファイルからの相対パスとして Kernel?.require するように設定します。

Module#autoload と似ていますが、feature の解決方法が Kernel?.require_relative と同様に autoload_relative を呼び出したファイルのディレクトリからの相対パスになる点が異なります。

const_name が autoload 設定されていて、まだ定義されてない(ロードされていない) ときは、autoload する対象を置き換えます。const_name が(autoload ではなく) 既に定義されているときは何もしません。

相対パスは絶対パスに変換されます。この絶対パスが Module#autoload? の返り値になります。

[PARAM] const_name:

String または Symbol で指定します。なお、const_name には、"::" 演算子を含めることはできません。つまり、self の直下に定義された定数しか指定できません。

[PARAM] feature:

呼び出し元のファイルからの相対パスで、autoload する対象を指定します。

[EXCEPTION] LoadError:

ファイルのコンテキストなしに呼び出された場合(eval の中など)に発生します。

module A
end
A.autoload_relative(:B, "b.rb")

[SEE_ALSO] Module#autoload

[SEE_ALSO] Kernel?.autoload_relative

[SEE_ALSO] Kernel?.require_relative