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