Bimap-envirAPI {AnnotationDbi}R Documentation

Environment-like API for Bimap objects

Description

These methods allow the user to manipulate any Bimap object as if it was an environment. This environment-like API is provided for backward compatibility with the traditional environment-based maps.

Usage

  ls(name, pos = -1L, envir = as.environment(pos), all.names = FALSE,
     pattern, sorted = TRUE)
  exists(x, where, envir, frame, mode, inherits)
  get(x, pos, envir, mode, inherits)
  #x[[i]]
  #x$name

  ## Converting to a list
  mget(x, envir, mode, ifnotfound, inherits)
  eapply(env, FUN, ..., all.names, USE.NAMES)
  #contents(object, all.names)

  ## Additional convenience method
  sample(x, size, replace=FALSE, prob=NULL, ...)

Arguments

name

A Bimap object for ls. A key as a literal character string or a name (possibly backtick quoted) for x$name.

pos

Ignored.

envir

Ignored for ls. A Bimap object for mget, get and exists.

all.names

Ignored.

USE.NAMES

Ignored.

pattern

An optional regular expression. Only keys matching 'pattern' are returned.

x

The key(s) to search for for exists, get and mget. A Bimap object for [[ and x$name. A Bimap object or an environment for sample.

where

Ignored.

frame

Ignored.

mode

Ignored.

inherits

Ignored.

i

Single key specifying the map element to extract.

ifnotfound

A value to be used if the key is not found. Only NA is currently supported.

env

A Bimap object.

FUN

The function to be applied (see original eapply for environments for the details).

...

Optional arguments to FUN.

size

Non-negative integer giving the number of map elements to choose.

replace

Should sampling be with replacement?

prob

A vector of probability weights for obtaining the elements of the map being sampled.

sorted

Ignored

See Also

ls, exists, get, mget, eapply, contents, sample, BimapFormatting, Bimap

Examples

  library(hgu95av2.db)
  x <- hgu95av2CHRLOC

  ls(x)[1:3]
  exists(ls(x)[1], x)
  exists("titi", x)
  get(ls(x)[1], x)
  x[[ls(x)[1]]]
  x$titi # NULL

  mget(ls(x)[1:3], x)
  eapply(x, length)
  contents(x)

  sample(x, 3)

[Package AnnotationDbi version 1.30.1 Index]