The R Project SVN R

% File src/library/base/man/structure.Rd
% Part of the R package, https://www.R-project.org
% Copyright 1995-2026 R Core Team
% Distributed under GPL 2 or later

\name{structure}
\title{Attribute Specification}
\usage{
structure(.Data, \dots)
}
\alias{structure}
\arguments{
  \item{.Data}{an object which will have
    various attributes attached to it.  From \R 4.5.0, this must not be
    \code{\link{NULL}} (previously deprecated for years), nor any
    \code{\link{symbol}} or \code{\link{primitive}} function.}
  \item{\dots}{attributes, specified in \code{tag = value}
    form, which will be attached to data.}
}
\description{
  \code{structure} returns the given object with further
  \link{attributes} set.
}
\details{
  Adding a class \code{"factor"} will ensure that numeric codes are
  given integer storage mode.

  The historical feature to rename
  attributes \code{".Dim"}, \code{".Dimnames"}, \code{".Names"},
  \code{".Tsp"} and \code{".Label"} is deprecated since \R version 4.7.0.

  It is possible to give the same tag more than once, in which case the
  last value assigned wins.  As with other ways of assigning attributes,
  using \code{tag = NULL} removes attribute \code{tag} from \code{.Data} if
  it is present.
}
\seealso{
  \code{\link{attributes}}, \code{\link{attr}}.
}
\references{
  \bibshow{R:Becker+Chambers+Wilks:1988}
}
\examples{
structure(1:6, dim = 2:3)
}
\keyword{attribute}
\keyword{manip}