read_utf8: Read / write files encoded in UTF-8

In xfun: Supporting Functions for Packages Maintained by 'Yihui Xie'

Read / write files encoded in UTF-8

Description

Read or write files, assuming they are encoded in UTF-8. read_utf8() is roughly readLines(encoding = 'UTF-8') (a warning will be issued if non-UTF8 lines are found), and write_utf8() calls writeLines(enc2utf8(text), useBytes = TRUE).

Usage

read_utf8(con, error = FALSE)

write_utf8(text, con, ...)

append_utf8(text, con, sort = TRUE)

append_unique(text, con, sort = function(x) base::sort(unique(x)))

Arguments

con	A connection or a file path.
error	Whether to signal an error when non-UTF8 characters are detected (if FALSE, only a warning message is issued).
text	A character vector (will be converted to UTF-8 via enc2utf8()).
...	Other arguments passed to writeLines() (except useBytes, which is TRUE in write_utf8()).
sort	Logical (FALSE means not to sort the content) or a function to sort the content; TRUE is equivalent to base::sort.

Details

The function append_utf8() appends UTF-8 content to a file or connection based on read_utf8() and write_utf8(), and optionally sort the content. The function append_unique() appends unique lines to a file or connection.

Value

read_utf8() returns a character vector of the file content; write_utf8() returns the con argument (invisibly).

xfun documentation built on April 3, 2025, 7:04 p.m.