copyEnv               package:Biobase               R Documentation

_L_i_s_t-_E_n_v_i_r_o_n_m_e_n_t _i_n_t_e_r_a_c_t_i_o_n_s

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

     These functions can be used to make copies of environments, or to
     get/assign all of the objects inside of an environment.

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

     copyEnv(oldEnv, newEnv, all.names=FALSE)
     l2e(vals, envir)

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

  oldEnv: An environment to copy from

  newEnv: An environment to copy to.  If missing, a new environment
          with the same parent environment as oldEnv.

   envir: An environment to get/set values to.  For 'l2e' this can be
          left missing and a new 'environment' of an appropriate size
          will be returned.

    vals: A named list of objects to assign into an environment

all.names: Whether to retrieve objects with names that start with a
          dot.

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

     'l2e': This function takes a named list and assigns all of its
     elements into an environment (using the names to name the
     objects). Unless you have an existing environment which you want
     to reuse, it is best to omit the 'envir' argument.  This way, the
     function will create a new environment with an efficient initial
     size.

     'copyEnv': This function will make a copy of the contents from
     'oldEnv' and place them into 'newEnv'.

_A_u_t_h_o_r(_s):

     Jeff Gentry and R. Gentleman

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

     'environment', 'as.list'

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

        z <- new.env(hash=TRUE, parent=emptyenv(), size=29L)
        multiassign(c("a","b","c"), c(1,2,3), z)

        a <- copyEnv(z)
        ls(a)

        q <- as.list(z)
        g <- new.env(hash=TRUE, parent=emptyenv(), size=29L)
        g <- l2e(q, g)
        ls(g)
        g2 <- l2e(q)

