

   LLiisstt OObbjjeeccttss

        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)

   AArrgguummeennttss::

       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.

   DDeessccrriippttiioonn::

        `ls' and `objects' return a vector of character strings
        giving the names of the objects in the specified envi-
        ronment.  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'.

   SSeeee AAllssoo::

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

   EExxaammpplleess::

        .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"

