to_encoding: Deep conversion to an encoding

In krlmlr/utf8: Portable Tools for 'UTF-8' Character Data

Deep conversion to an encoding

Description

Converts all characters directly or indirectly contained in an object to a specific encoding. This works even if the encoding is different in the elements of a character vector.

Usage

to_encoding

to_utf8(x, ...)

to_native(x, ...)

to_latin1(x, ...)

to_alien(x, ...)

## S3 method for class 'character'
to_encoding(x, ..., converter)

Arguments

x	A character vector.
...	passed on to methods
converter	A function that accepts a character value as first argument and returns a (possibly classed) character with the desired encoding

Format

An object of class function of length 1.

Details

to_utf8

converts to UTF-8, using the utf8() class where possible. Implemented as to_encoding(x, as_utf8)

to_native

converts to the native encoding. Implemented as to_encoding(x, enc2native) on Windows and as to_encoding(x, as_utf8) on Linux and OS X

to_latin1

converts to the latin-1 encoding

to_alien

converts to the "other" encoding, i.e., UTF-8 on Windows and latin-1 on Linux and OS X.

See Also

• rlang::as_utf8_character() and iconv() for different ways to convert character vectors to Unicode

Examples

to_utf8(letters)
to_utf8(iris)
class(levels(to_utf8(iris)$Species))

krlmlr/utf8 documentation built on Feb. 4, 2024, 10:20 a.m.