url: 削除するファイルまたはディレクトリを示す Url オブジェクト。

error-if-missing?: ファイルまたはディレクトリが url に存在しない場合に例外をスローするかどうかを制御する bool フラグで、以下のようになります。

• true (既定値)。MissingFileException がスローされます。
• false。例外がスローされず、ファイルを削除できなかったことは示されません。

recurse?: ディレクトリの内容も同様に削除するかどうかを示す bool フラグで、以下のようになります。

• true。url にディレクトリが指定されている場合は、そのディレクトリ内のファイルとサブディレクトリもディレクトリと同様に削除されます。
• false (既定値)。url で指定されたディレクトリ内のファイルまたはサブディレクトリが削除されないことを意味します。url にディレクトリが指定されている場合は、 IOException がスローされます。

例外のスロー

このプロシージャはアトミックではありません。

error-if-missing? = false を指定してもこのプロシージャが MissingFileException をスローしないとは限りません。たとえば、別のプロセスがタイミング悪く url を削除した場合などにはエラーがスローされます。

同様に、recurse? = true, error-if-missing? = false かつ url がディレクトリを参照する場合は、障害が検出される前に url の一部が削除され、url だった古いディレクトリが部分的に削除されたままになることが考えられます。この問題は、別のプロセスに干渉されなくても発生する場合があります。たとえば、url の 1 つ以上のサブディレクトリに対するファイルシステム保護設定が不適当な場合は、削除操作が正常に完了できなくなるおそれがあります。