multiget               package:Biobase               R Documentation

_R_e_t_u_r_n _a _l_i_s_t _c_o_n_t_a_i_n_i_n_g _t_h_e _V_a_l_u_e_s _o_f _t_h_e _s_u_p_p_l_i_e_d _v_a_r_i_a_b_l_e_s.

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

     Search for an R objects with a given names and return the values
     found.

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

     multiget(x, pos=-1, envir=as.environment(pos), mode="any",
     inherits=TRUE, iffail)

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

       x: a vector or list of variable names (given as a quoted
          character strings).

     pos: where to look for the object (see the details section); if
          omitted, the function will search, as if the name of the
          object appeared in unquoted in an expression. 

   envir: an alternative way to specify an environment to look in; see
          the details section.

    mode: the mode of object sought.

inherits: should the enclosing frames of the environment be inspected?

  iffail: A value to be used for items in the list that are not found.

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

     The 'pos' argument can specify the  environment in which to look
     for the object in any of several ways: as an integer (the position
     in the 'search' list); as the character string name of an element
     in the search list; or as an 'environment' (including using
     'sys.frame' to access the currently active function calls). The
     'envir' argument is an alternative way to specify an environment,
     but is primarily there for back compatibility.

     The 'mode' includes collections such as '"numeric"' and
     '"function"': any member of the collection will suffice.

_V_a_l_u_e:

     A named list (the names come from 'x') of the variables found. If
     'iffail' was specified then any object named in 'x' that is not
     found will have the value of 'iffail' as its value. Each variable
     lookup is wrappted in a 'try' call so that failure to find one
     variable does not prevent finding others.

     This function searches the specified environment for a bound
     variable whose name is given by the character string 'x'.  If the
     variable's value is not of the correct 'mode', it is ignored.

     If 'inherits' is 'FALSE', only the first frame of the specified
     environment is inspected.  If 'inherits' is 'TRUE', the search is
     continued up through the parent frames until a bound value of the
     right mode is found.

     Using a 'NULL' environment is equivalent to using the current
     environment.

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

     'exists', 'multiassign'.

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

     nam <- paste("r",1:6, sep=".")

     multiassign(nam, 11:16)
     rm("r.3")
     multiget(nam, iffail=NA)

