# The logical class
Logical is a mode (and an implicit class) for vectors.
# Logical operators
There are two sorts of logical operators: those that accept and return vectors of any length (elementwise operators: !
, |
, &
, xor()
) and those that only evaluate the first element in each argument (&&
, ||
). The second sort is primarily used as the cond
argument to the if
function.
Logical Operator | Meaning | Syntax |
---|---|---|
! | Not | !x |
& | element-wise (vectorized) and | x & y |
&& | and (single element only) | x && y |
element-wise (vectorized) or | ||
xor | element-wise (vectorized) exclusive OR | xor(x,y) |
Note that the ||
operator evaluates the left condition and if the left condition is TRUE the right side is never evaluated. This can save time if the first is the result of a complex operation. The &&
operator will likewise return FALSE without evaluation of the second argument when the first element of the first argument is FALSE.
> x <- 5
> x > 6 || stop("X is too small")
Error: X is too small
> x > 3 || stop("X is too small")
[1] TRUE
To check whether a value is a logical you can use the is.logical()
function.
# Coercion
To coerce a variable to a logical use the as.logical()
function.
> x <- 2
> z <- x > 4
> z
[1] FALSE
> class(x)
[1] "numeric"
> as.logical(2)
[1] TRUE
When applying as.numeric()
to a logical, a double will be returned. NA
is a logical value and a logical operator with an NA
will return NA
if the outcome is ambiguous.
# Interpretation of NAs
See Missing values (opens new window) for details.
> TRUE & NA
[1] NA
> FALSE & NA
[1] FALSE
> TRUE || NA
[1] TRUE
> FALSE || NA
[1] NA
# Remarks
# Shorthand
TRUE
, FALSE
and NA
are the only values for logical vectors; and all three are reserved words. T
and F
can be shorthand for TRUE
and FALSE
in a clean R session, but neither T
nor F
are reserved, so assignment of non-default values to those names can set users up for difficulties.