Learn R Programming
R.utils (version 2.0.2)

attachLocally.list: Assigns an objects elements locally

Description

Assigns an objects elements locally.

Usage

## S3 method for class 'list':
attachLocally(object, fields=NULL, excludeFields=NULL, overwrite=TRUE,
  envir=parent.frame(), ...)

Arguments

object
An object with named elements such as an environment, a list, or a data.frame.
fields
A character vector specifying elements to be copied. If NULL, all elements are considered.
excludeFields
A character vector specifying elements not to be copied. This has higher priority than fields.
overwrite
If FALSE, fields that already exists will not be copied.
envir
The environment where elements are copied to.
...
Not used.

Value

See Also

attachLocally() of class Object. attach().

Examples

Run this code
foo <- function(object) {
  cat("Local objects in foo():
")
  print(ls())

  attachLocally(object)

  cat("Local objects in foo():
")
  print(ls())

  for (name in ls()) {
    cat("Object '", name, "':
", sep="")
    print(get(name, inherits=FALSE))
  }
}

a <- "A string"
l <- list(a=1:10, msg="Hello world", df=data.frame(a=NA, b=2))
foo(l)
print(a)

Run the code above in your browser using DataLab