README.md

In inops: Infix Operators for Detection, Subsetting and Replacement

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 of in, 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

1. 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.

1. 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.

1. intrval
2. operators
3. infix
4. invctr
5. grapes

inops documentation built on Nov. 19, 2019, 5:08 p.m.