The R Project SVN R

Rev

Rev 25118 | Rev 42333 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 25118 Rev 25816
Line 1... Line 1...
1
\name{show}
1
\name{show}
2
\alias{show}
2
\alias{show}
-
 
3
\alias{show-methods}
-
 
4
\alias{show,ANY-method}
-
 
5
\alias{show,traceable-method}
-
 
6
\alias{show,ObjectsWithPackage-method}
-
 
7
\alias{show,MethodDefinition-method}
-
 
8
\alias{show,MethodWithNext-method}
-
 
9
\alias{show,genericFunction-method}
-
 
10
\alias{show,classRepresentation-method}
3
\title{Show an Object}
11
\title{Show an Object}
4
\description{
12
\description{
5
  Display the object, by printing, plotting or whatever suits its class.
13
  Display the object, by printing, plotting or whatever suits its
-
 
14
  class.  This function exists to be specialized by methods.  The
-
 
15
  default method calls \code{\link{showDefault}}.
6
 
16
 
7
  The function \code{show} exists to be specialized by methods; the
-
 
8
  default method calls \code{showDefault}.
17
  Formal methods for \code{show} will
9
 
-
 
10
  With package \pkg{methods} attached, methods for \code{show} will
-
 
11
  usually be invoked for automatic printing (see the details).
18
  usually be invoked for automatic printing (see the details).
12
 
-
 
13
  The function \code{showDefault} allows redirection of output and
-
 
14
  optional use of old-style print methods, but normally will not be
-
 
15
  called directly.
-
 
16
}
19
}
17
\usage{
20
\usage{
18
show(object)
21
show(object)
19
 
-
 
20
showDefault(object, oldMethods = TRUE)
-
 
21
}
22
}
22
\arguments{
23
\arguments{
23
  \item{object}{Any R object}
24
  \item{object}{Any R object}
24
  
-
 
25
  \item{oldMethods}{Should old-style print methods be used for this
-
 
26
    object?  \code{TRUE} by default if called directly, but \code{FALSE}
-
 
27
    when called from the \pkg{methods} package for automatic printing (to
-
 
28
    avoid potential recursion; see the details below).
-
 
29
  }
25
   }
30
}
26
}
31
\value{
27
\value{
32
  \code{show} returns an invisible \code{NULL}.
28
  \code{show} returns an invisible \code{NULL}.
33
 
-
 
34
  For \code{showDefault}, if \code{printTo} is \code{FALSE}, the value
-
 
35
  is a character vector containing the lines that would otherwise have
-
 
36
  been printed.
-
 
37
}
29
}
38
\details{
30
\details{
39
  The \pkg{methods} package overrides the base definition of
31
  The \pkg{methods} package overrides the base definition of
40
  \code{print.default} to arrange for automatic printing to honor
32
  \code{print.default} to arrange for automatic printing to honor
41
  methods for the function \code{show}.  This does not quite manage to
33
  methods for the function \code{show}.  This does not quite manage to