Bimap-envirAPI: Environment-like API for Bimap objects

Bimap-envirAPIR 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)

  ## 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, all.names, USE.NAMES, where, frame, mode, inherits

Ignored.

envir

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

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.

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

logical(1). When TRUE (default), return primary keys in sorted order.

See Also

ls, exists, get, mget, eapply, 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)

  sample(x, 3)

Bioconductor/AnnotationDbi documentation built on Nov. 4, 2023, 7:32 p.m.