1% File src/library/base/man/invisible.Rd
2% Part of the R package, https://www.R-project.org
3% Copyright 1995-2007 R Core Team
4% Distributed under GPL 2 or later
5
6\name{invisible}
7\alias{invisible}
8\title{Change the Print Mode to Invisible}
9\description{
10  Return a (temporarily) invisible copy of an object.
11}
12\usage{invisible(x)}
13\arguments{
14  \item{x}{an arbitrary \R object.}
15}
16\details{
17  This function can be useful when it is desired to have functions
18  return values which can be assigned, but which do not print when they
19  are not assigned.
20
21  This is a \link{primitive} function.
22}
23\references{
24  Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988)
25  \emph{The New S Language}.
26  Wadsworth & Brooks/Cole.
27}
28\seealso{
29  \code{\link{withVisible}},
30  \code{\link{return}},
31  \code{\link{function}}.
32}
33\examples{
34# These functions both return their argument
35f1 <- function(x) x
36f2 <- function(x) invisible(x)
37f1(1)  # prints
38f2(1)  # does not
39}
40\keyword{programming}
41