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