| Line 19... |
Line 19... |
| 19 |
\details{
|
19 |
\details{
|
| 20 |
Optionally, \R can be built to collate character strings by ICU
|
20 |
Optionally, \R can be built to collate character strings by ICU
|
| 21 |
(\url{http://site.icu-project.org}). For such systems,
|
21 |
(\url{http://site.icu-project.org}). For such systems,
|
| 22 |
\code{icuSetCollate} can be used to tune the way collation is done.
|
22 |
\code{icuSetCollate} can be used to tune the way collation is done.
|
| 23 |
On other builds calling this function does nothing, with a warning.
|
23 |
On other builds calling this function does nothing, with a warning.
|
| 24 |
|
24 |
|
| 25 |
Possible arguments are
|
25 |
Possible arguments are
|
| 26 |
\describe{
|
26 |
\describe{
|
| 27 |
\item{\code{locale}:}{A character string such as \code{"da_DK"} giving the
|
27 |
\item{\code{locale}:}{A character string such as \code{"da_DK"} giving the
|
| 28 |
country whose collation rules are to be used. If present, this
|
28 |
country whose collation rules are to be used. If present, this
|
| 29 |
should be the first argument.}
|
29 |
should be the first argument.}
|
| Line 49... |
Line 49... |
| 49 |
tertiary, used to distinguish large and small Japanese Kana
|
49 |
tertiary, used to distinguish large and small Japanese Kana
|
| 50 |
characters. Possible values \code{"on"} and \code{"off"} (default).}
|
50 |
characters. Possible values \code{"on"} and \code{"off"} (default).}
|
| 51 |
\item{\code{hiragana_quaternary}:}{Possible values \code{"on"} (sort
|
51 |
\item{\code{hiragana_quaternary}:}{Possible values \code{"on"} (sort
|
| 52 |
Hiragana first at quaternary level) and \code{"off"}.}
|
52 |
Hiragana first at quaternary level) and \code{"off"}.}
|
| 53 |
}
|
53 |
}
|
| 54 |
Only the first three are likely to be of interest except to those with a
|
54 |
Only the first three are likely to be of interest except to those with a
|
| 55 |
detailed understanding of collation and specialized requirements.
|
55 |
detailed understanding of collation and specialized requirements.
|
| 56 |
|
56 |
|
| 57 |
Some examples are \code{case_level = "on", strength = "primary"} to ignore
|
57 |
Some examples are \code{case_level = "on", strength = "primary"} to ignore
|
| 58 |
accent differences and \code{alternate_handling = "shifted"} to ignore
|
58 |
accent differences and \code{alternate_handling = "shifted"} to ignore
|
| 59 |
space and punctuation characters.
|
59 |
space and punctuation characters.
|
| Line 65... |
Line 65... |
| 65 |
As from \R 2.9.0, ICU is used by default wherever it is available:
|
65 |
As from \R 2.9.0, ICU is used by default wherever it is available:
|
| 66 |
this include Mac OS >= 10.4 and many Linux installations.
|
66 |
this include Mac OS >= 10.4 and many Linux installations.
|
| 67 |
}
|
67 |
}
|
| 68 |
\seealso{
|
68 |
\seealso{
|
| 69 |
\link{Comparison}, \code{\link{sort}}
|
69 |
\link{Comparison}, \code{\link{sort}}
|
| 70 |
|
70 |
|
| 71 |
The ICU user guide chapter on collation
|
71 |
The ICU user guide chapter on collation
|
| 72 |
(\url{http://userguide.icu-project.org/collation}).
|
72 |
(\url{http://userguide.icu-project.org/collation}).
|
| 73 |
}
|
73 |
}
|
| 74 |
\examples{\donttest{
|
74 |
\examples{\donttest{
|
| 75 |
## these examples depend on having ICU available, and on the locale
|
75 |
## these examples depend on having ICU available, and on the locale
|