| as | R Documentation |
Coerce an object to a given class.
as(object, Class, strict=TRUE, ext) as(object, Class) <- value
object |
any R object. |
Class |
the name of the class to which |
strict |
logical flag. If If |
value |
The value to use to modify |
ext |
an optional object
defining how |
as(object)
returns the version of this object coerced to be the given
Class. When used in the replacement form on the left of
an assignment, the portion of the object corresponding to
Class is replaced by value.
The operation of as() in either form depends on the
definition of coerce methods. Methods are defined automatically
when the two classes are related by inheritance; that is, when
one of the classes is a subclass of the other.
Coerce methods are also predefined for basic classes (including all the types of vectors, functions and a few others).
Beyond these two sources of methods, further methods are defined
by calls to the setAs function. See that
documentation also for details of how coerce methods work. Use
showMethods(coerce) for a list of all currently defined methods, as in the
example below.
Methods are pre-defined for coercing any object to one of the basic
datatypes. For example, as(x, "numeric") uses the existing
as.numeric function. These and all other existing methods
can be listed as shown in the example.
Chambers, John M. (2016) Extending R, Chapman & Hall. (Chapters 9 and 10.)
If you think of using try(as(x, cl)), consider
canCoerce(x, cl) instead.
## Show all the existing methods for as()
showMethods("coerce")
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.
