operator_compare: Compare Strings with or without Collation
Description
Relational operators for comparing corresponding strings in two character vectors, with a typical R look-and-feel.
Usage
e1 %s<% e2
e1 %s<=% e2
e1 %s>% e2
e1 %s>=% e2
e1 %s==% e2
e1 %s!=% e2
e1 %s===% e2
e1 %s!==% e2
e1 %stri<% e2
e1 %stri<=% e2
e1 %stri>% e2
e1 %stri>=% e2
e1 %stri==% e2
e1 %stri!=% e2
e1 %stri===% e2
e1 %stri!==% e2
Arguments
|
character vectors or objects coercible to character vectors |
Details
These functions call stri_cmp_le or its friends, using the default collator options. As a consequence, they are vectorized over e1 and e2.
%stri==% tests for canonical equivalence of strings (see stri_cmp_equiv) and is a locale-dependent operation.
%stri===% performs a locale-independent, code point-based comparison.
Value
All the functions return a logical vector indicating the result of a pairwise comparison. As usual, the elements of shorter vectors are recycled if necessary.
See Also
The official online manual of stringi at https://stringi.gagolewski.com/
Gagolewski M., stringi: Fast and portable character string processing in R, Journal of Statistical Software 103(2), 2022, 1-59, doi:10.18637/jss.v103.i02
Other locale_sensitive: about_locale, about_search_boundaries, about_search_coll, stri_compare(), stri_count_boundaries(), stri_duplicated(), stri_enc_detect2(), stri_extract_all_boundaries(), stri_locate_all_boundaries(), stri_opts_collator(), stri_order(), stri_rank(), stri_sort_key(), stri_sort(), stri_split_boundaries(), stri_trans_tolower(), stri_unique(), stri_wrap()
Examples
'a' %stri<% 'b'
## [1] TRUE
c('a', 'b', 'c') %stri>=% 'b'
## [1] FALSE TRUE TRUE