| Line 1... |
Line 1... |
| 1 |
% File src/library/base/man/iconv.Rd
|
1 |
% File src/library/base/man/iconv.Rd
|
| 2 |
% Part of the R package, http://www.R-project.org
|
2 |
% Part of the R package, http://www.R-project.org
|
| 3 |
% Copyright 1995-2012 R Core Team
|
3 |
% Copyright 1995-2013 R Core Team
|
| 4 |
% Distributed under GPL 2 or later
|
4 |
% Distributed under GPL 2 or later
|
| 5 |
|
5 |
|
| 6 |
\name{iconv}
|
6 |
\name{iconv}
|
| 7 |
\alias{iconv}
|
7 |
\alias{iconv}
|
| 8 |
\alias{iconvlist}
|
8 |
\alias{iconvlist}
|
| Line 62... |
Line 62... |
| 62 |
}
|
62 |
}
|
| 63 |
|
63 |
|
| 64 |
\section{Implementation Details}{
|
64 |
\section{Implementation Details}{
|
| 65 |
There are three main implementations of \code{iconv} in use.
|
65 |
There are three main implementations of \code{iconv} in use.
|
| 66 |
\samp{glibc} (as used on Linux) contains one. Several platforms
|
66 |
\samp{glibc} (as used on Linux) contains one. Several platforms
|
| 67 |
supply GNU \samp{libiconv}, including OS X, FreeBSD and Cygwin.
|
67 |
supply GNU \samp{libiconv}, including OS X, FreeBSD and Cygwin, in
|
| 68 |
On Windows we use a version of Yukihiro Nakadaira's \samp{win_iconv},
|
68 |
some cases with additional encodings. On Windows we use a version of
|
| 69 |
which is based on Windows' codepages. All three have
|
69 |
Yukihiro Nakadaira's \samp{win_iconv}, which is based on Windows'
|
| 70 |
\code{iconvlist}, ignore case in encoding names and support
|
70 |
codepages. (We have added several encoding names for compatibility
|
| - |
|
71 |
with other systems.) All three have \code{iconvlist}, ignore case in
|
| 71 |
\samp{//TRANSLIT} (but with different results, and for
|
72 |
encoding names and support \samp{//TRANSLIT} (but with different
|
| 72 |
\samp{win_iconv} currently a \sQuote{best fit} strategy is used except
|
73 |
results, and for \samp{win_iconv} currently a \sQuote{best fit}
|
| 73 |
for \code{to = "ASCII"}).
|
74 |
strategy is used except for \code{to = "ASCII"}).
|
| 74 |
|
75 |
|
| 75 |
Most commercial Unixes contain an implemetation of \code{iconv} but
|
76 |
Most commercial Unixes contain an implemetation of \code{iconv} but
|
| 76 |
none we have encountered have supported the encoding names we need:
|
77 |
none we have encountered have supported the encoding names we need:
|
| 77 |
the \dQuote{R Installation and Administration Manual} recommends
|
78 |
the \dQuote{R Installation and Administration Manual} recommends
|
| 78 |
installing GNU \samp{libiconv} on Solaris and AIX, for example.
|
79 |
installing GNU \samp{libiconv} on Solaris and AIX, for example.
|
| Line 106... |
Line 107... |
| 106 |
(if conversion fails) or a raw vector.
|
107 |
(if conversion fails) or a raw vector.
|
| 107 |
|
108 |
|
| 108 |
For \code{iconvlist()}, a character vector (typically of a few hundred
|
109 |
For \code{iconvlist()}, a character vector (typically of a few hundred
|
| 109 |
elements).
|
110 |
elements).
|
| 110 |
}
|
111 |
}
|
| - |
|
112 |
\note{
|
| - |
|
113 |
The only reasonably portable name for the ISO 8859-15 encoding,
|
| - |
|
114 |
commonly known as \sQuote{Latin 9}, is \code{"latin-9"}: some
|
| - |
|
115 |
platforms support \code{"latin9"} but GNU \samp{libiconv} does not.
|
| - |
|
116 |
}
|
| - |
|
117 |
|
| 111 |
\seealso{
|
118 |
\seealso{
|
| 112 |
\code{\link{localeToCharset}}, \code{\link{file}}.
|
119 |
\code{\link{localeToCharset}}, \code{\link{file}}.
|
| 113 |
}
|
120 |
}
|
| 114 |
\examples{
|
121 |
\examples{
|
| 115 |
## In principle, not all systems have iconvlist
|
122 |
## In principle, not all systems have iconvlist
|
The R Project SVN
R