vector produces a vector of the given length and mode.
as.vector, a generic, attempts to coerce its argument into a
vector of mode
mode (the default is to coerce to whichever
vector mode is most convenient): if the result is atomic all
attributes are removed.
x is a vector of the
specified mode having no attributes other than names. It returns
1 2 3
character string naming an atomic mode or
a non-negative integer specifying the desired length.
For a long vector, i.e.,
an R object.
The atomic modes are
mode = "any",
is.vector may return
the atomic modes,
mode, it will return
x has any
attributes except names. (This is incompatible with S.) On the other
as.vector removes all attributes including names
for results of atomic mode (but not those of mode
Note that factors are not vectors;
as.vector converts a factor to a character
mode = "any".
vector, a vector of the given length and mode. Logical
vector elements are initialized to
FALSE, numeric vector
0, character vector elements to
vector elements to
nul bytes and list/expression elements to
as.vector, a vector (atomic or of type list or expression).
All attributes are removed from the result if it is of an atomic mode,
but not in general for a list result. The default method handles 24
input types and 12 values of
type: the details of most
coercions are undocumented and subject to change.
is.vector(x, mode = "numeric") can be true for vectors of types
is.vector(x, mode =
"double") can only be true for those of type
Writers of methods for
as.vector need to take care to
follow the conventions of the default method. In particular
mode can be
"any", any of the atomic
"pairlist" or one of the aliases
The return value should be of the appropriate mode. For
mode = "any" this means an atomic vector or list.
Attributes should be treated appropriately: in particular when the result is an atomic vector there should be no attributes, not even names.
is.vector(as.vector(x, m), m) should be true for any
m, including the default
is.vector are quite distinct from the
meaning of the formal class
"vector" in the methods
package, and hence
as(x, "vector") and
as.vector(x) is not necessarily a null operation if
is.vector(x) is true: any names will be removed from an atomic
"pairlist" are accepted but have long been undocumented: they
are used to implement
as.pairlist, and those functions should preferably be
used directly. None of the description here applies to those
modes: see the help for the preferred forms.
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
df <- data.frame(x = 1:3, y = 5:7) ## Error: try(as.vector(data.frame(x = 1:3, y = 5:7), mode = "numeric")) x <- c(a = 1, b = 2) is.vector(x) as.vector(x) all.equal(x, as.vector(x)) ## FALSE ###-- All the following are TRUE: is.list(df) ! is.vector(df) ! is.vector(df, mode = "list") is.vector(list(), mode = "list")