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. The
          names must not include 'NA' or '""' and should be unique.

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.  If the names of 'vals' are not unique, a warning will be
     raised.  The returned environment will contain the value
     associated with the last occurance of any given duplicated name.

     '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)

