## List Objects

## Usage

    ls(name, pos= -1, envir=pos.to.env(pos),
           all.names=FALSE, pattern)
    objects(name, pos= -1, envir=pos.to.env(pos),
           all.names=FALSE, pattern)

## Arguments

`name` | the name of an attached object appearing in the vector of names returned by `search`.
`pos` | the index of an attached object in the list returned by `search`. Defaults to the current environment.
`envir` | an evaluation environment. Defaults to the one corresponding to `pos`.
`all.names` | a logical value. If `TRUE`, all object names are returned. If `FALSE`, names which begin with a ``.'' are omitted.
`pattern` | an optional regular expression, see `grep`. Only names matching `pattern` are returned.

## Description

`ls` and `objects` return a vector of character strings giving the names of the objects in the specified environment. When invoked with no argument at the top level prompt, `ls` shows what data sets and functions a user has defined. When invoked with no argument inside a function, `ls` returns the names of the functions local variables. This is useful in conjunction with `browser`.

## See Also

`apropos` (or `find`) for finding objects in the whole search path; `grep` for more details on ``regular expressions''; `class`, `methods`, etc. for object-oriented programming.

## Examples

    .Ob <- 1
    ls(pat="O")
    ls(pat="O", all = T)    # also shows ".[foo]"

    # shows an empty list because inside myfunc no variables are defined
    myfunc _ function() {ls()}
    myfunc()

    # define a local variable inside myfunc
    myfunc _ function() {y_1; ls()}
    myfunc()                # shows "y"

[Package Contents]