# read

    .read path:{String} lines:{Range = Range.INFINITE} -> String

Content copied to clipboard

#### Return

a string value of the text extracted from the file

#### Parameters

path

path of the file (with extension)

lines

- Optional

range of lines to extract from the file. If not specified or infinite, the whole file is read

#### Throws

IllegalArgumentException

if lines is out of bounds

#### Permissions

project-read
to read files located in the project directory
global-read
to read files located outside the project directory

#### Wiki page

file-data