AnnDbBimap-envirAPI {AnnotationDbi} | R Documentation

## Environment-like API for AnnDbBimap objects

### Description

These methods allow the user to manipulate any AnnDbBimap 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, envir, all.names, pattern)
      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)
      #contents(object, all.names)

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

### Arguments

`name` | An AnnDbBimap 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`. An AnnDbBimap object for `mget`, `get` and `exists`.
`all.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`. An AnnDbBimap object for `[[` and `x$name`. An AnnDbBimap 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` | An AnnDbBimap 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.

### 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.6.1 Index]