【Ruby3.x】Dir::entries()メソッドの使い方
entriesメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
entriesメソッドは、指定したディレクトリ内のファイル名、サブディレクトリ名、および特別なエントリ名を文字列の配列として取得するメソッドです。このメソッドはRubyのDirクラスに属するクラスメソッドであり、Dir.entries(パス)のように呼び出して利用します。
引数には、内容をリストアップしたいディレクトリのパスを文字列で指定します。例えば、Dir.entries("/path/to/my_directory")と記述すると、そのディレクトリ内に含まれるすべてのエントリの名前が取得できます。戻り値は、これらのエントリ名を格納した文字列の配列です。
このメソッドの重要な特徴として、戻り値の配列には、カレントディレクトリを示す"."（ドット）と、親ディレクトリを示す".." （ドット二つ）という二つの特殊なエントリが必ず含まれるという点が挙げられます。これは、多くのファイルシステムにおける基本的なディレクトリ構造の概念を反映した動作です。もし、これらの特殊なエントリを除外して、純粋なファイルやサブディレクトリの名前だけを取得したい場合は、Rubyの他の関連するメソッドの利用を検討すると良いでしょう。
entriesメソッドは、特定のディレクトリにどのようなファイルやサブディレクトリが存在するかを確認したり、ファイルシステムを探索するプログラムを作成する際に、非常に基礎的で重要な機能を提供します。
構文(syntax)
1Dir.entries(".")
引数(parameters)
dirname, encoding: nil
- dirname: 検索対象のディレクトリパス
- encoding: nil: ファイル名のエンコーディングを指定する文字列。nilの場合はデフォルトのエンコーディングが使用される。
戻り値(return)
Array
指定されたディレクトリ内のファイルおよびディレクトリの名前を文字列の配列として返します。