api / org.gradle.api / Script / file

file

abstract fun file(path: Any): File

Resolves a file path relative to the directory containing this script. This works as described for

Parameters

path - The object to resolve as a File.

Return
The resolved file. Never returns null.

abstract fun file(path: Any, validation: PathValidation): File

Resolves a file path relative to the directory containing this script and validates it using the given scheme. See PathValidation for the list of possible validations.

Parameters

path - An object to resolve as a File.

validation - The validation to perform on the file.

Exceptions

InvalidUserDataException - When the file does not meet the given validation constraint.

Return
The resolved file. Never returns null.