Description
Infix Operators for Detection, Subsetting and Replacement.
Description
Infix operators to detect, subset, and replace the elements matched by a given condition. The functions have several variants of operator types, including subsets, ranges, regular expressions and others. Implemented operators work on vectors, matrices, and lists.
README.md
inops
Package implementing additional infix operators for R.
Implemented operators work with 4 different value types: sets, intervals, regular expressions, and counts.
And provide 3 distinct functionalities: detection, subsetting, and replacement.
For more examples please see the vignette.
For a complete list of available operators consult the tables below.
Syntax
All operators have the same form composed of two distinct parts: %<operation><type>%.
[operation]specifies the performed functionality and can be one ofin,out,[in,[out.[type]specifies the type of operation and can be one of{},[],(),[),(],~,~p,~f,#.
Detection Operators
| Form | Description | Call |
|---|---|---|
%in{}% | which elements are inside a set | x %in{}% set |
%in[]% | which elements are inside a closed interval | x %in[]% interval |
%in()% | which elements are inside an open interval | x %in()% interval |
%in[)% | which elements are inside an interval open on the right | x %in[)% interval |
%in(]% | which elements are inside an interval open on the left | x %in(]% interval |
%in~% | which elements match a regular expression | x %in~% pattern |
%in~p% | which elements match a regular perl expression | x %in~p% pattern |
%in~f% | which elements match a regular fixed expression | x %in~f% pattern |
%in#% | which elements occur a specified number of times | x %in#% count |
%out% | which elements are outside a set (same as ! x %in% y) | x %out% set |
%out{}% | which elements are outside a set | x %out{}% set |
%out[]% | which elements are outside a closed interval | x %out[]% interval |
%out()% | which elements are outside an open interval | x %out()% interval |
%out[)% | which elements are outside an interval open on the right | x %out[)% interval |
%out(]% | which elements are outside an interval open on the left | x %out(]% interval |
%out~% | which elements do not match a regular expression | x %out~% pattern |
%out~p% | which elements do not match a regular perl expression | x %out~p% pattern |
%out~f% | which elements do not match a regular fixed expression | x %out~f% pattern |
%out#% | which elements occur other than a specified number of times | x %out#% count |
Subsetting Operators
| Form | Description | Call |
|---|---|---|
%[==% | select elements equal to the provided value | x %[==% element |
%[!=% | select elements not equal to the provided value | x %[!=% element |
%[>% | select elements greater than the provided value | x %[>% number |
%[<% | select elements lower than the provided value | x %[<% number |
%[>=% | select elements greater or equal to the provided value | x %[>=% number |
%[<=% | select elements lower or equal to the provided value | x %[<=% number |
%[in% | select elements inside a set | x %[in% set |
%[in{}% | select elements inside a set | x %[in{}% set |
%[in[]% | select elements inside a closed interval | x %[in[]% interval |
%[in()% | select elements inside an open interval | x %[in()% interval |
%[in[)% | select elements inside an interval open on the right | x %[in[)% interval |
%[in(]% | select elements inside an interval open on the left | x %[in(]% interval |
%[in~% | select elements matching a regular expression | x %[in~% pattern |
%[in~p% | select elements matching a regular perl expression | x %[in~p% pattern |
%[in~f% | select elements matching a regular fixed expression | x %[in~f% pattern |
%[in#% | select elements that occur a specified number of times | x %[in#% count |
%[out% | select elements outside a set | x %[out% set |
%[out{}% | select elements outside a set | x %[out{}% set |
%[out[]% | select elements outside a closed interval | x %[out[]% interval |
%[out()% | select elements outside an open interval | x %[out()% interval |
%[out[)% | select elements outside an interval open on the right | x %[out[)% interval |
%[out(]% | select elements outside an interval open on the left | x %[out(]% interval |
%[out~% | select elements not matching a regular expression | x %[out~% pattern |
%[out~p% | select elements not matching a regular perl expression | x %[out~p% pattern |
%[out~f% | select elements not matching a regular fixed expression | x %[out~f% pattern |
%[out#% | select elements that occur other than specified number of times | x %[out% count |
Replacement Operators
| Form | Description | Call |
|---|---|---|
==<- | change elements equal to the provided value | x == element <- value |
!=<- | change elements not equal to the provided value | x != element <- value |
><- | change elements greater than the provided value | x > number <- value |
<<- | change elements lower than the provided value | x < number <- value |
>=<- | change elements greater or equal to the provided value | x >= number <- value |
<=<- | change elements lower or equal to the provided value | x <= number <- value |
%in%<- | change elements inside a set | x %in% set <- value |
%in{}%<- | change elements inside a set | x %in{}% set <- value |
%in[]%<- | change elements inside a closed interval | x %in[]% interval <- value |
%in()%<- | change elements inside an open interval | x %in()% interval <- value |
%in[)%<- | change elements inside an interval open on the right | x %in[)% interval <- value |
%in(]%<- | change elements inside an interval open on the left | x %in(]% interval <- value |
%in~%<- | change elements matching a regular expression | x %in~% pattern <- value |
%in~p%<- | change elements matching a regular perl expression | x %in~p% pattern <- value |
%in~f%<- | change elements matching a regular fixed expression | x %in~f% pattern <- value |
%in#%<- | change elements that occur specified number of times | x %in#% count <- value |
%out%<- | change elements outside a set | x %out% set <- value |
%out{}%<- | change elements outside a set | x %out{}% set <- value |
%out[]%<- | change elements outside a closed interval | x %out[]% interval <- value |
%out()%<- | change elements outside an open interval | x %out()% interval <- value |
%out[)%<- | change elements outside an interval open on the right | x %out[)% interval <- value |
%out(]%<- | change elements outside an interval open on the left | x %out(]% interval <- value |
%out~%<- | change elements not matching a regular expression | x %out~% pattern <- value |
%out~p%<- | change elements not matching a regular perl expression | x %out~p% pattern <- value |
%out~f%<- | change elements not matching a regular fixed expression | x %out~f% pattern <- value |
%out#%<- | change elements that occur other than specified number of times | x %out#% count <- value |
Notes
- Overloading
To give an assignment counterpart to < we had to overload the <<- operator, which explains the message when attaching the package. This doesn’t affect the behavior of the <<- assignments.
- Behaviour
Detection operators should be seen as an extension of the standard infix operators implemented in R (i.e. ==, >, etc). For this reason the implemented operators differ from standard %in% and behave more like == on data.frames and objects with NA values.
Subsetting and replacement operators are wrappers around detection operators.
Subsetting: x[ x %in{}% set].
Replacement: replace(x, x %in{}% set, value).
See Also
Other similar packages you might be interested in.