stri_opts_fixed: Generate a List with Fixed Pattern Search Engine’s Settings

Description

A convenience function used to tune up the behavior of stri_*_fixed functions, see stringi-search-fixed.

Usage

stri_opts_fixed(case_insensitive = FALSE, overlap = FALSE)

Arguments

case_insensitive

logical; enable simple case insensitive matching

overlap

logical; enable overlapping matches’ detection

Details

Case-insensitive matching uses a simple, single-code point case mapping (via ICU’s u_toupper() function). Full case mappings should be used whenever possible because they produce better results by working on whole strings. They also take into account the string context and the language, see stringi-search-coll.

Searching for overlapping pattern matches is available in stri_extract_all_fixed, stri_locate_all_fixed, and stri_count_fixed functions.

Value

Returns a named list object.

Author(s)

Marek Gagolewski and other contributors

References

C/POSIX Migration – ICU User Guide, https://unicode-org.github.io/icu/userguide/icu/posix.html

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 search_fixed: about_search, about_search_fixed

Examples

stri_detect_fixed('ala', 'ALA') # case-sensitive by default
## [1] FALSE
stri_detect_fixed('ala', 'ALA', opts_fixed=stri_opts_fixed(case_insensitive=TRUE))
## [1] TRUE
stri_detect_fixed('ala', 'ALA', case_insensitive=TRUE) # equivalent
## [1] TRUE