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.

inops_operator_table

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

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


Try the inops package in your browser

Any scripts or data that you put into this service are public.

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