Movatterモバイル変換

Or

Description

The special binary function%or% can be used to specify a setof optional matches.

Usage

x %or% yor(...)

Arguments

See Also

Other rex:capture(),character_class(),counts,group(),lookarounds,not(),rex(),shortcuts,wildcards

Regular Expression

Description

Specify an explicit regular expression. This expression must already beescaped.

Usage

## S3 method for class 'regex'as.character(x, ...)## S3 method for class 'regex'print(x, ...)regex(x, ...)

Arguments

Methods (by generic)

• as.character: coerce regex object to a character

• print: Print regex object

See Also

as.regex to coerce to a regex object.

Coerce objects to aregex.

Description

Coerce objects to aregex.

Usage

as.regex(x, ...)## Default S3 method:as.regex(x, ...)

Arguments

Methods (by class)

• default: Simply escape the Object.

Create a capture group

Description

Used to save the matched value within the group for use later in the regularexpression or to extract the values captured. Both named and unnamed groupscan later be referenced usingcapture_group.

Usage

capture(..., name = NULL)capture_group(name)

Arguments

See Also

group for grouping without capturing. Perl 5 CaptureGroupshttps://perldoc.perl.org/perlre#Capture-groups

Other rex:%or%(),character_class(),counts,group(),lookarounds,not(),rex(),shortcuts,wildcards

Examples

# Match paired quotation marksre <- rex(  # first quotation mark  capture(quotes),  # match all non-matching quotation marks  zero_or_more(except(capture_group(1))),  # end quotation mark (matches first)  capture_group(1))#named capture - don't match apples to orangesre <- rex(  capture(name = "fruit", or("apple", "orange")),  "=",  capture_group("fruit"))

Create character classes

Description

There are multiple ways you can define a character class.

Usage

character_class(x)one_of(...)any_of(..., type = c("greedy", "lazy", "possessive"))some_of(..., type = c("greedy", "lazy", "possessive"))none_of(...)except_any_of(..., type = c("greedy", "lazy", "possessive"))except_some_of(..., type = c("greedy", "lazy", "possessive"))range(start, end)`:`(start, end)exclude_range(start, end)

Arguments

Functions

• character_class: explicitly define a character class

• one_of: matches one of the specified characters.

• any_of: matches zero or more of the specified characters.

• some_of: matches one or more of the specified characters.

• none_of: matches anything but one of the specified characters.

• except_any_of: matches zero or more of anything but the specified characters.

• except_some_of: matches one or more of anything but the specified characters.

• range: matches one of any of the characters in the range.

• :: matches one of any of the characters in the range.

• exclude_range: matches one of any of the characters except those in the range.

See Also

Other rex:%or%(),capture(),counts,group(),lookarounds,not(),rex(),shortcuts,wildcards

Examples

# grey = grayre <- rex("gr", one_of("a", "e"), "y")grepl(re, c("grey", "gray")) # TRUE TRUE# Match non-vowelsre <- rex(none_of("a", "e", "i", "o", "u"))# They can also be in the same stringre <- rex(none_of("aeiou"))grepl(re, c("k", "l", "e")) # TRUE TRUE FALSE# Match rangere <- rex(range("a", "e"))grepl(re, c("b", "d", "f")) # TRUE TRUE FALSE# Explicit creationre <- rex(character_class("abcd\\["))grepl(re, c("a", "d", "[", "]")) # TRUE TRUE TRUE FALSE

Character class escapes

Description

Character class escapes

Usage

character_class_escape(x)## S3 method for class 'regex'character_class_escape(x)## S3 method for class 'character_class'character_class_escape(x)## S3 method for class 'character'character_class_escape(x)## S3 method for class 'list'character_class_escape(x)## Default S3 method:character_class_escape(x)

Arguments

Methods (by class)

• regex: objects are passed through unchanged.

• character_class: objects are passed through unchanged.

• character: objects properly escaped for character classes.

• list: callcharacter_class_escape on all elements of the list.

• default: coerce tocharacter andcharacter_class_escape.

Counts

Description

Functions to restrict a regex to a specific number

Usage

n_times(x, n, type = c("greedy", "lazy", "possessive"))between(x, low, high, type = c("greedy", "lazy", "possessive"))at_least(x, n, type = c("greedy", "lazy", "possessive"))at_most(x, n, type = c("greedy", "lazy", "possessive"))

Arguments

Functions

• n_times:x must occur exactlyn times.

• between:x must occur betweenlow andhigh times.

• at_least:x must occur at leastn times.

• at_most:x must occur at mostn times.

See Also

Other rex:%or%(),capture(),character_class(),group(),lookarounds,not(),rex(),shortcuts,wildcards

Escape characters for a regex

Description

Escape characters for a regex

Usage

escape(x)## S3 method for class 'regex'escape(x)## S3 method for class 'character_class'escape(x)## S3 method for class 'character'escape(x)## Default S3 method:escape(x)## S3 method for class 'list'escape(x)

Arguments

Methods (by class)

• regex: Objects are simply passed through unchanged.

• character_class: Objects are surrounded by braces.

• character: Objects are properly escaped for regular expressions.

• default: default escape coerces to character and escapes.

• list: simply call escape on all elements of the list.

Create a grouped expression

Description

This is similar tocapture except that it does not store thevalue of the group. Best used when you want to combine several partstogether and do not reference or extract the grouped value later.

Usage

group(...)

Arguments

See Also

capture for grouping with capturing. Perl 5 ExtendedPatternshttps://perldoc.perl.org/perlre#Extended-Patterns

Other rex:%or%(),capture(),character_class(),counts,lookarounds,not(),rex(),shortcuts,wildcards

Lookarounds

Description

Lookarounds

Usage

x %if_next_is% yx %if_next_isnt% yx %if_prev_is% yx %if_prev_isnt% y

Arguments

Details

These functions provide an interface to perl lookarounds.

Special binary functions are used to infer an ordering, since often youmight wish to match a word / set of characters conditional on the startand end of that word.

• %if_next_is%:TRUE if x follows y

• %if_next_isnt%:TRUE if x does not follow y

• %if_prev_is%:TRUE if y comes before x

• %if_prev_isnt%:TRUE if y does not come before x

See Also

Perl 5 Documentationhttps://perldoc.perl.org/perlre#Extended-Patterns

Other rex:%or%(),capture(),character_class(),counts,group(),not(),rex(),shortcuts,wildcards

Examples

stopifnot(grepl(rex("crab" %if_next_is% "apple"), "crabapple", perl = TRUE))stopifnot(grepl(rex("crab" %if_prev_is% "apple"), "applecrab", perl = TRUE))stopifnot(grepl(rex(range("a", "e") %if_next_isnt% range("f", "g")),  "ah", perl = TRUE))stopifnot(grepl(rex(range("a", "e") %if_next_is% range("f", "i")),  "ah", perl = TRUE))

Do not match

Description

Do not match

Usage

not(..., type = c("greedy", "lazy", "possessive"))

Arguments

See Also

Other rex:%or%(),capture(),character_class(),counts,group(),lookarounds,rex(),shortcuts,wildcards

Match function

Description

Match function

Usage

re_matches(  data,  pattern,  global = FALSE,  options = NULL,  locations = FALSE,  ...)

Arguments

Value

if no captures, returns a logical vector the same length as theinput character vector specifying if the relevant value matched or not. Ifthere are captures in the regular expression, returns adata.frame with acolumn for each capture group. Ifglobal isTRUE, returns alist ofdata.frames.

See Also

regexp Section "Perl-like Regular Expressions" for adiscussion of the supported options

Examples

string <- c("this is a", "test string")re_matches(string, rex("test")) # FALSE FALSE# named capturere_matches(string, rex(capture(alphas, name = "first_word"), space,  capture(alphas, name = "second_word")))#   first_word second_word# 1       this          is# 2       test      string# capture returns NA when it fails to matchre_matches(string, rex(capture("test")))#      1# 1 test# 2 <NA>

Substitute regular expressions in a string with another string.

Description

Substitute regular expressions in a string with another string.

Usage

re_substitutes(data, pattern, replacement, global = FALSE, options = NULL, ...)

Arguments

See Also

regexp Section "Perl-like Regular Expressions" for adiscussion of the supported options

Examples

string <- c("this is a Test", "string")re_substitutes(string, "test", "not a test", options = "insensitive")re_substitutes(string, "i", "x", global = TRUE)re_substitutes(string, "(test)", "not a \\1", options = "insensitive")

Register the Rex shortcuts

Description

If you are using rex in another package you need to call this function toregister all of the rex shortcuts so that spurious NOTEs about globalvariables being generated during R CMD check.

Usage

register_shortcuts(pkg_name)

Arguments

Generate a regular expression.

Description

Generate a regular expression.

Usage

rex(..., env = parent.frame())

Arguments

See Also

Other rex:%or%(),capture(),character_class(),counts,group(),lookarounds,not(),shortcuts,wildcards

Togglesrex mode.

Description

While within rex mode, functions used within therex functionare attached, so one can get e.g. auto-completion within editors.

Usage

rex_mode()

Shortcuts

Description

Commonly used character classes and regular expressions. These shortcutsare substituted insiderex calls.

Usage

shortcuts

Format

An object of classshortcut of length 116.

Details

names(shortcuts) will give you the full list of available shortcuts.

See Also

Other rex:%or%(),capture(),character_class(),counts,group(),lookarounds,not(),rex(),wildcards

Single shortcuts

Description

Each of these shortcuts has both a plural (-s) and inverse (non_) form.

Usage

single_shortcuts

Format

An object of classshortcut of length 18.

Wildcards

Description

Wildcards

Usage

zero_or_more(..., type = c("greedy", "lazy", "possessive"))one_or_more(..., type = c("greedy", "lazy", "possessive"))maybe(..., type = c("greedy", "lazy", "possessive"))

Arguments

Functions

• zero_or_more: match... zero or more times.

• one_or_more: match... one or more times.

• maybe: match... zero or one times.

See Also

Other rex:%or%(),capture(),character_class(),counts,group(),lookarounds,not(),rex(),shortcuts