Test if an object is not sorted (in increasing order), without the
cost of sorting it.
Usage
is.unsorted(x, na.rm = FALSE, strictly = FALSE)
Arguments
x
an R object with a class or a numeric, complex, character,
logical or raw vector.
na.rm
logical. Should missing values be removed before checking?
strictly
logical indicating if the check should be for
strictly increasing values.
Value
A length-one logical value. All objects of length 0 or 1 are sorted.
Otherwise, the result will be NA except for atomic vectors and
objects with an S3 class (where the >= or > method is
used to compare x[i] with x[i-1] for i in
2:length(x)) or with an S4 class where you have to provide a
method for is.unsorted().
%% FIXME: rather want '>' and '>=' methods for S4 classes be sufficient