Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Ruby3.x】Dir::empty?()メソッドの使い方

empty?メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

empty?メソッドは、RubyのDirクラスに属し、指定されたパスのディレクトリが空であるかどうかを判定するメソッドです。引数には確認したいディレクトリへのパスを文字列で渡します。

このメソッドは、指定されたディレクトリ内に通常のファイルやサブディレクトリが一つも存在しない場合にtrueを返します。一つでもファイルやサブディレクトリが存在する場合はfalseを返します。ファイルシステムが内部的に管理する特殊なエントリである.(カレントディレクトリ自身)や..(親ディレクトリ)は、ディレクトリが空であるかどうかの判断には影響しません。

存在しないパスを指定した場合や、指定されたパスがディレクトリではなくファイルであった場合など、パスが不適切である場合にはSystemCallError系の例外が発生する可能性があります。そのため、empty?メソッドを呼び出す際には、あらかじめFile.directory?などのメソッドでパスが有効なディレクトリであることを確認するか、例外処理を適切に行うことが安全なプログラミングにおいて推奨されます。

このメソッドは、例えば、アプリケーションが新しいファイルを保存する前に特定のディレクトリが空であることを確認したり、プログラムがディレクトリを削除する前にその中身が本当に何もないことを保証したりするような場面で役立ちます。ディレクトリの状態を安全かつ効率的に判断するための、非常に基本的ながらも重要な機能です。

構文(syntax)

1Dir.empty?("path/to/directory")

引数(parameters)

path

  • path: Dir.empty? メソッドがチェックするディレクトリのパスを表す文字列

戻り値(return)

Boolean

Dir.empty? は、指定されたディレクトリが空かどうかを判定し、その結果を真偽値(true または false)で返します。ディレクトリ内にファイルやサブディレクトリが存在しない場合は true を、一つでも存在する場合は false を返します。

関連コンテンツ