Skip to contents

This object is given as input to each linter


get_source_expressions(filename, lines = NULL)



the file to be parsed.


a character vector of lines. If NULL, then filename will be read.


A list with three components:


a list of n+1 objects. The first n elements correspond to each expression in filename, and consist of a list of 9 elements:

  • filename (character)

  • line (integer) the line in filename where this expression begins

  • column (integer) the column in filename where this expression begins

  • lines (named character) vector of all lines spanned by this expression, named with the line number corresponding to filename

  • parsed_content (data.frame) as given by utils::getParseData() for this expression

  • xml_parsed_content (xml_document) the XML parse tree of this expression as given by xmlparsedata::xml_parse_data()

  • content (character) the same as lines as a single string (not split across lines)

  • (Deprecated) find_line (function) a function for returning lines in this expression

  • (Deprecated) find_column (function) a similar function for columns

The final element of expressions is a list corresponding to the full file consisting of 6 elements:

  • filename (character)

  • file_lines (character) the readLines() output for this file

  • content (character) for .R files, the same as file_lines; for .Rmd scripts, this is the extracted R source code (as text)

  • full_parsed_content (data.frame) as given by utils::getParseData() for the full content

  • full_xml_parsed_content (xml_document) the XML parse tree of all expressions as given by xmlparsedata::xml_parse_data()

  • terminal_newline (logical) records whether filename has a terminal newline (as determined by readLines() producing a corresponding warning)


A Lint object describing any parsing error.


The readLines() output for this file.


The file is read in using the encoding setting. This setting found by taking the first valid result from the following locations

  1. The encoding key from the usual lintr configuration settings.

  2. The Encoding field from a Package DESCRIPTION file in a parent directory.

  3. The Encoding field from an R Project .Rproj file in a parent directory.

  4. "UTF-8" as a fallback.