

   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 global
             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.  Only names match-
             ing `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' for finding objects in the whole search path;
        `class', `methods', etc. for object-oriented program-
        ming.

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

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

