\HeaderA{utf8Conversion}{Convert to or from UTF-8-encoded Character Vectors}{utf8Conversion}
\aliasA{intToUtf8}{utf8Conversion}{intToUtf8}
\aliasA{utf8ToInt}{utf8Conversion}{utf8ToInt}
\keyword{character}{utf8Conversion}
\keyword{utilities}{utf8Conversion}
\begin{Description}\relax
Conversion of UTF-8 encoded character vectors to and from integer vectors.
\end{Description}
\begin{Usage}
\begin{verbatim}
utf8ToInt(x)
intToUtf8(x, multiple = FALSE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] object to be converted.
\item[\code{multiple}] logical: should the conversion be to a single
character string or multiple individual characters?
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
These will work in any locale, including on machines that do not
otherwise support multi-byte character sets.
\end{Details}
\begin{Value}
\code{utf8ToInt} converts a length-one character string encoded in
UTF-8 to an integer vector of (numeric) UTF-8 code points.

\code{intToUtf8} converts a vector of (numeric) UTF-8 code points
either to a single character string or a character vector of single
characters.  (For a single character string \code{0} is silently
omitted: otherwise \code{0} is mapped to \code{""}.  Non-integral
numeric values are truncated to integers.)  The
\code{\LinkA{Encoding}{Encoding}} is declared as \code{"UTF-8"}.
\end{Value}
\begin{Examples}
\begin{ExampleCode}## Not run: 
## will only display in some locales and fonts
intToUtf8(0x03B2L) # Greek beta
## End(Not run)\end{ExampleCode}
\end{Examples}

