【Ruby3.x】File::unlink()メソッドの使い方
unlinkメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
unlinkメソッドは、指定されたファイルや空のディレクトリをシステムから削除するメソッドです。
このメソッドは、引数として削除したいファイルやディレクトリのパスを一つ以上受け取ります。例えば、File.unlink("path/to/file.txt")のように使用することで、指定されたfile.txtを削除できます。複数のパスを指定することも可能で、その場合はFile.unlink("file1.txt", "file2.txt")のようにカンマで区切って渡します。
削除に成功した場合、このメソッドは常に数値の0を返します。指定されたファイルが存在しない場合や、削除する権限がない場合、あるいは指定されたパスが空ではないディレクトリである場合には、Errno::ENOENTやErrno::EACCESなどの例外が発生し、処理が中断されます。
ディレクトリを削除する際は、そのディレクトリが空である必要があります。もしディレクトリ内にファイルやサブディレクトリが存在する場合は削除できません。シンボリックリンクを指定した場合、削除されるのはリンク自体であり、リンクの指す元のファイルやディレクトリは削除されません。
また、File.unlinkはFile.deleteメソッドと同じ機能を持つエイリアスです。どちらを使用しても同じ結果が得られます。ファイルシステムの操作を行う際には、意図しないデータ消失を防ぐため、十分な注意と確認が必要です。
構文(syntax)
1File.unlink("file_to_delete.txt")
引数(parameters)
*rest
- path: 削除するファイルまたはディレクトリのパスを指定する文字列。複数指定可能。
戻り値(return)
Integer
unlinkメソッドは、指定されたファイルを削除します。削除が成功した場合は、削除したファイル数を整数で返します。