Hide navigation sidebar
Hide table of contents sidebar
Back to top
Edit this page
Toggle table of contents sidebar

# stri_read_lines: Read Text Lines from a Text File

## Description

Reads a text file in ins entirety, re-encodes it, and splits it into text lines.

## Usage

    stri_read_lines(con, encoding = NULL, fname = con)

## Arguments

`con` | name of the output file or a connection object (opened in the binary mode)
`encoding` | single string; input encoding; `NULL` or `''` for the current default encoding.
`fname` | [DEPRECATED] alias of `con`

## Details

This aims to be a substitute for the `readLines` function, with the ability to re-encode the input file in a much more robust way, and split the text into lines with `stri_split_lines1` (which conforms with the Unicode guidelines for newline markers).

The function calls `stri_read_raw`, `stri_encode`, and `stri_split_lines1`, in this order.

Because of the way this function is currently implemented, maximal file size cannot exceed ~0.67 GB.

## Value

Returns a character vector, each text line is a separate string. The output is always marked as UTF-8.

## Author(s)

Marek Gagolewski and other contributors

## See Also

The official online manual of stringi at https://stringi.gagolewski.com/

Gagolewski M., stringi: Fast and portable character string processing in R, Journal of Statistical Software 103(2), 2022, 1-59, doi:10.18637/jss.v103.i02

Other files: `stri_read_raw()`, `stri_write_lines()`