utf8: A simple class for storing UTF-8 strings

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

A simple class for storing UTF-8 strings

Description

The values are stored as a character() vector. On construction, the enc2utf8() function is called on the input. Subsetting and concatenation operations on an object of this class return an object of this class again. Calls to Encoding<-() are not intercepted.

Usage

utf8(x = character())

is_utf8(x)

as_utf8(x, ...)

## Default S3 method:
as_utf8(x, ...)

## S3 method for class ''NULL''
as_utf8(x, ...)

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

## S3 method for class 'utf8'
as_utf8(x, ...)

## S3 method for class 'utf8'
as.character(x, ...)

## S3 method for class 'utf8'
as.data.frame(
  x,
  row.names = NULL,
  optional = FALSE,
  ...,
  nm = paste(deparse(substitute(x), width.cutoff = 500L), collapse = " ")
)

## S3 method for class 'utf8'
format(x, ...)

## S3 method for class 'utf8'
print(x, ...)

Arguments

x	A vector
...	Arguments passed on to further methods.
row.names	NULL or a character vector giving the row names for the data frame. Missing values are not allowed.
optional	logical. If TRUE, setting row names and converting column names (to syntactic names: see make.names) is optional. Note that all of R's base package as.data.frame() methods use optional only for column names treatment, basically with the meaning of data.frame(*, check.names = !optional). See also the make.names argument of the matrix method.
nm	Name of column in new data frame

Examples

utf8(letters)
utf8("ä")
utf8(iconv("ä", to = "latin1"))

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