Read rectangular files

These functions parse rectangular files (like csv or fixed-width format) into tibbles. They specify the overall structure of the file, and how each line is divided up into fields.

Read a delimited file (including csv & tsv) into a tibble

Read a fixed width file into a tibble

Read common/combined log file into a tibble

Read whitespace-separated columns into a tibble

Column specification

The column specification describes how each column is parsed from a character vector in to a more specific data type. readr does make an educated guess about the type of each column, but you’ll need override those guesses when it gets them wrong.

Create column specification

Retrieve parsing problems

Generate a column specification

Examine the column specifications for a data frame

Column parsers

Column parsers define how a single column is parsed, or a parse a single vector. Each parser comes in two forms: parse_xxx() which is used to parse vectors that already exist in R and col_xxx() which is used to parse vectors as they are loaded by a read_xxx() function.

Skip a column

Parse logicals, integers, and reals

Parse date/times

Parse factors

Parse using the "best" type

Parse numbers, flexibly

Locale controls

The “locale” controls all options that vary from country-to-country or language-to-language. This includes things like the character used as the decimal mark, the names of days of the week, and the encoding. See vignette("locales") for more details.

Create or retrieve date names

Create locales

Write rectangular files

Despite its name, readr also provides a number of functions to write data frames to disk, or to convert them to in-memory strings.

Convert a data frame to a delimited string

Write a data frame to a delimited file

Low-level IO and debugging tools

These functions can be used with non-rectangular files, binary data, and to help debug rectangular files that fail to parse.

Count the number of fields in each line of a file

Guess encoding of file

Read/write a complete file

Read/write lines to/from a file

Re-convert character columns in existing data frame

Chunked API

The chunked API allows you to read in files that are larger than memory, processing a chunk at a time. The API experimental: please try it out but be aware that it may change in the future.

Callback classes

Read a delimited file by chunks

Read lines from a file or string by chunk.