{"Package":"enc","Title":"Portable Tools for 'UTF-8' Character Data","Date":"2018-02-24","Version":"0.2.0","Authors@R":"person(\"Kirill\", \"Mller\", role = c(\"aut\", \"cre\"), email = \"krlmlr+r@mailbox.org\")","Description":"\nImplements an S3 class for storing 'UTF-8' strings, based on regular character vectors.\nAlso contains routines to portably read and write 'UTF-8' encoded text files,\nto convert all strings in an object to 'UTF-8',\nand to create character vectors with various encodings.","Depends":"R (>= 3.1)","Imports":"methods","Suggests":"digest, pillar, readr, rlang, testthat, withr","License":"GPL-3","Encoding":"UTF-8","LazyData":"true","BugReports":"https://github.com/krlmlr/enc/issues","URL":"https://github.com/krlmlr/enc","RoxygenNote":"6.0.1.9000","NeedsCompilation":"yes","Packaged":"2018-03-03 00:03:50 UTC; muelleki","Author":"Kirill Mller [aut, cre]","Maintainer":"Kirill Mller ","Repository":"CRAN","Date/Publication":"2018-03-03 14:03:13 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/enc_0.2.0.tar.gz","jsonAuthors":[{"name":"Kirill Mller","email":"krlmlr+r@mailbox.org","maintainer":true}],"readme":"\nenc\n===\n\n[![Travis-CI Build Status](https://travis-ci.org/krlmlr/enc.svg?branch=master)](https://travis-ci.org/krlmlr/enc) [![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/krlmlr/enc?branch=master&svg=true)](https://ci.appveyor.com/project/krlmlr/enc) [![codecov](https://codecov.io/gh/krlmlr/enc/branch/master/graph/badge.svg)](https://codecov.io/gh/krlmlr/enc) [![CRAN\\_Status\\_Badge](http://www.r-pkg.org/badges/version/enc)](https://cran.r-project.org/package=enc)\n\nPortable tools for UTF-8 character data\n\nR and character encoding\n------------------------\n\nThe [character encoding](https://en.wikipedia.org/wiki/Character_encoding) of determines the translation of the letters, digits, or other codepoints (atomic components of a text) into a sequence of bytes. A byte sequence may translate into valid text in one character encoding, but give nonsense in other character encodings.\n\nFor historic reasons, R can store strings in different ways:\n\n1. in the \"native\" encoding, the default encoding of the operating system\n2. in [UTF-8](https://en.wikipedia.org/wiki/UTF-8), the most prevalent and versatile encoding nowadays\n3. in \"latin1\", a popular encoding in Western Europe\n4. as \"bytes\", leaving the interpretation to the user\n\nOn OS X and Linux, the \"native\" encoding is often UTF-8, but on Windows it is not. To add to the confusion, the encoding is a property of individual strings in a character vector, and not of the entire vector.\n\nWhy UTF-8?\n----------\n\nWhen working with text, it is advisable to use UTF-8, because it allows encoding virtually any text, even in foreign languages that contain symbols that cannot be represented in your system's native encoding. The UTF-8 encoding possesses several nice technical properties, and is by far the predominant encoding on the Web. Standardization on a \"universal\" encoding faciliates data exchange.\n\nBecause of R's special handling of strings, some care must be taken to make sure that you're actually using the UTF-8 encoding. Many functions in R will hide encoding issues from you, and transparently convert to UTF-8 as necessary. However, some functions (such as reading and writing files) will stubbornly prefer the native encoding.\n\nThe enc pacakge provides helpers for converting all textual components of an object to UTF-8, and for reading and writing files in UTF-8 (with a LF end-of-line terminator by default). It also defines an S3 class for tagging all-UTF-8 character vectors and ensuring that updates maintain the UTF-8 encoding. Examples for other packages that use UTF-8 by default are:\n\n- [readr](http://readr.tidyverse.org/), [readxl](http://readxl.tidyverse.org/), and [haven](http://haven.tidyverse.org/) for data input and output\n\n- [stringi](https://cran.r-project.org/package=stringi) and [stringr](http://stringr.tidyverse.org/) for string manipulation\n\n- [testthat](http://testthat.r-lib.org/) and [roxygen2](https://cran.r-project.org/package=roxygen2) for package development\n\nExample\n-------\n\n``` r\nlibrary(enc)\nutf8(c(\"a\", \"ä\"))\n#> [1] \"a\" \"ä\"\nas_utf8(1)\n#> [1] \"1\"\n\na <- utf8(\"ä\")\na[2] <- \"ö\"\nclass(a)\n#> [1] \"utf8\"\n\ndata.frame(abc = letters[1:3], utf8 = utf8(letters[1:3]))\n#> abc utf8\n#> 1 a a\n#> 2 b b\n#> 3 c c\n```\n\nInstall the package from GitHub:\n\n``` r\n# install.packages(\"devtools\")\ndevtools::install_github(\"krlmlr/enc\")\n```","jobInfo":{"package":"enc","version":"0.2.0","parsingStatus":"success","parserVersion":1,"parsedAt":"2019-06-24T11:30:31+0000"}}

Description

Usage

Arguments