readr (version 1.0.0)

read_lines: Read lines from a file or string.

Description

Read lines from a file or string.

Usage

read_lines(file, skip = 0, n_max = -1L, locale = default_locale(), na = character(), progress = interactive())
read_lines_raw(file, skip = 0, n_max = -1L, progress = interactive())

Arguments

file

Either a path to a file, a connection, or literal data (either a single string or a raw vector).

Files ending in .gz, .bz2, .xz, or .zip will be automatically uncompressed. Files starting with http://, https://, ftp://, or ftps:// will be automatically downloaded. Remote gz files can also be automatically downloaded & decompressed.

Literal data is most useful for examples and tests. It must contain at least one new line to be recognised as data (instead of a path).

skip

Number of lines to skip before reading data.

n_max

Number of lines to read. If n_max is -1, all lines in file will be read.

locale

The locale controls defaults that vary from place to place. The default locale is US-centric (like R), but you can use locale to create your own locale that controls things like the default time zone, encoding, decimal mark, big mark, and day/month names.

na

Character vector of strings to use for missing values. Set this option to character() to indicate no missing values.

progress

Display a progress bar? By default it will only display in an interactive session. The display is updated every 50,000 values and will only display if estimated reading time is 5 seconds or more.

Value

read_lines: A character vector with one element for each line. read_lines_raw: A list containing a raw vector for each line.

Examples

read_lines(readr_example("mtcars.csv"))
read_lines("1\n\n2")
read_lines("\n")

read_lines_raw(readr_example("mtcars.csv"))