file

fun File.file(): File

Atomically creates a new, empty file named by this abstract pathname if and only if a file with this name does not yet exist. The check for the existence of the file and the creation of the file if it does not exist are a single operation that is atomic with respect to all other filesystem activities that might affect the file.

Note: this method should not be used for file-locking, as the resulting protocol cannot be made to work reliably. The java.nio.channels.FileLock facility should be used instead.

Return

The current file

Throws

If an I/O error occurred
If a security manager exists and its
[java.lang.SecurityManager#checkWrite(String)]
method denies write access to the file