{"Package":"enc","Title":"Portable Tools for 'UTF-8' Character Data","Date":"2019-12-19","Version":"0.2.2","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":"7.0.2","NeedsCompilation":"yes","Packaged":"2019-12-19 13:58:09 UTC; kirill","Author":"Kirill Mller [aut, cre]","Maintainer":"Kirill Mller ","Repository":"CRAN","Date/Publication":"2019-12-19 16:50:13 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/enc_0.2.2.tar.gz","jsonAuthors":[{"name":"Kirill Mller","email":"krlmlr+r@mailbox.org","maintainer":true}],"readme":"\n# enc\n\n\n\n[![Lifecycle:\nexperimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)\n[![Travis-CI Build\nStatus](https://travis-ci.org/krlmlr/enc.svg?branch=master)](https://travis-ci.org/krlmlr/enc)\n[![AppVeyor Build\nStatus](https://ci.appveyor.com/api/projects/status/github/krlmlr/enc?branch=master&svg=true)](https://ci.appveyor.com/project/krlmlr/enc)\n[![codecov](https://codecov.io/gh/krlmlr/enc/branch/master/graph/badge.svg)](https://codecov.io/gh/krlmlr/enc)\n[![CRAN\\_Status\\_Badge](http://www.r-pkg.org/badges/version/enc)](https://cran.r-project.org/package=enc)\n\n\nPortable tools for UTF-8 character data\n\n## R and character encoding\n\nThe [character\nencoding](https://en.wikipedia.org/wiki/Character_encoding) of\ndetermines the translation of the letters, digits, or other codepoints\n(atomic components of a text) into a sequence of bytes. A byte sequence\nmay translate into valid text in one character encoding, but give\nnonsense 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\n system\n2. in [UTF-8](https://en.wikipedia.org/wiki/UTF-8), the most prevalent\n 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\nit is not. To add to the confusion, the encoding is a property of\nindividual strings in a character vector, and not of the entire vector.\n\n## Why UTF-8?\n\nWhen working with text, it is advisable to use UTF-8, because it allows\nencoding virtually any text, even in foreign languages that contain\nsymbols that cannot be represented in your system’s native encoding. The\nUTF-8 encoding possesses several nice technical properties, and is by\nfar the predominant encoding on the Web. Standardization on a\n“universal” encoding faciliates data exchange.\n\nBecause of R’s special handling of strings, some care must be taken to\nmake sure that you’re actually using the UTF-8 encoding. Many functions\nin R will hide encoding issues from you, and transparently convert to\nUTF-8 as necessary. However, some functions (such as reading and writing\nfiles) will stubbornly prefer the native encoding.\n\nThe enc package provides helpers for converting all textual components\nof an object to UTF-8, and for reading and writing files in UTF-8 (with\na LF end-of-line terminator by default). It also defines an S3 class for\ntagging all-UTF-8 character vectors and ensuring that updates maintain\nthe UTF-8 encoding. Examples for other packages that use UTF-8 by\ndefault are:\n\n - [readr](http://readr.tidyverse.org/),\n [readxl](http://readxl.tidyverse.org/), and\n [haven](http://haven.tidyverse.org/) for data input and output\n\n - [stringi](https://cran.r-project.org/package=stringi) and\n [stringr](http://stringr.tidyverse.org/) for string manipulation\n\n - [testthat](http://testthat.r-lib.org/) and\n [roxygen2](https://cran.r-project.org/package=roxygen2) for package\n development\n\n## Example\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.2","parsingStatus":"success","parserVersion":1,"parsedAt":"2019-12-19T18:30:11+0000"}}

Description

Usage

Arguments