class                  package:base                  R Documentation

_O_b_j_e_c_t _C_l_a_s_s_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     R possesses a simple generic function mechanism which can be used
     for an object-oriented style of programming.  Method dispatch
     takes place based on the class of the first argument to the
     generic function.

_U_s_a_g_e:

     class(x)
     class(x) <- value
     unclass(x)
     inherits(x, what, which = FALSE)

     oldClass(x)
     oldClass(x) <- value

_A_r_g_u_m_e_n_t_s:

       x: a R object

what, value: a character vector naming classes.

   which: logical affecting return value: see Details.

_D_e_t_a_i_l_s:

     Many R objects have a 'class' attribute, a character vector giving
     the names of the classes which the object "inherits" from.  If the
     object does not have a class attribute, it has an implicit class,
     '"matrix"', '"array"' or the result of 'mode(x)'.  (Functions
     'oldClass' and 'oldClass<-' get and set the attribute, which can
     also be done directly.)

     When a generic function 'fun' is applied to an object with class
     attribute 'c("first", "second")', the system searches for a
     function called 'fun.first' and, if it finds it, applies it to the
     object.  If no such function is found, a function called
     'fun.second' is tried. If no class name produces a suitable
     function, the function 'fun.default' is used (if it exists). If
     there is no class attribute, the implicit class is tried, then the
     default method.

     The function 'class' prints the vector of names of classes an
     object inherits from.  Correspondingly, 'class<-' sets the classes
     an object inherits from.

     'unclass' returns (a copy of) its argument with its class
     attribute removed.

     'inherits' indicates whether its first argument inherits from any
     of the classes specified in the 'what' argument.  If 'which' is
     'TRUE' then an integer vector of the same length as 'what' is
     returned. Each element indicates the position in the 'class(x)'
     matched by the element of 'what'; zero indicates no match. If
     'which' is 'FALSE' then 'TRUE' is  returned by 'inherits' if any
     of the names in 'what' match with any 'class'.

_F_o_r_m_a_l _c_l_a_s_s_e_s:

     An additional mechanism of _formal_ classes is available in
     packages 'methods' which is attached by default.  For objects
     which have a formal class, its name is returned by 'class' as a
     character vector of length one.

     The replacement version of the function sets the class to the
     value provided.  For classes that have a formal definition,
     directly replacing the class this way is strongly deprecated.  The
     expression 'as(object, value)' is the way to coerce an object to a
     particular class.

_N_o_t_e:

     Functions 'oldClass' and 'oldClass<-' behave in the same way as
     functions of those names in S-PLUS 5/6, _but_ in R 'UseMethod'
     dispatches on the class as returned by 'class' rather than
     'oldClass'.  _However_, group generics dispatch on the 'oldClass'
     for efficiency.

_S_e_e _A_l_s_o:

     'UseMethod', 'NextMethod', 'group generic'.

_E_x_a_m_p_l_e_s:

     x <- 10
     inherits(x, "a") #FALSE
     class(x) <- c("a", "b")
     inherits(x,"a") #TRUE
     inherits(x, "a", TRUE) # 1
     inherits(x, c("a", "b", "c"), TRUE) # 1 2 0

