MINI MINI MANI MO

%
% Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved.
%
\name{as.ore}
\alias{as.ore}
\alias{as.ore,ANY-method}
\alias{as.ore,Date-method}
\alias{as.ore,POSIXt-method}
\alias{as.ore,data.frame-method}
\alias{as.ore,difftime-method}
\alias{as.ore,matrix-method}
\alias{as.ore,vector-method}
\alias{as.ore,ore-method}
\alias{as.ore.vector}
\alias{as.ore.logical}
\alias{as.ore.logical,ANY-method}
\alias{as.ore.logical,ore-method}
\alias{as.ore.logical,ore.logical-method}
\alias{as.ore.integer}
\alias{as.ore.integer,ANY-method}
\alias{as.ore.integer,ore-method}
\alias{as.ore.integer,ore.integer-method}
\alias{as.ore.numeric}
\alias{as.ore.numeric,ANY-method}
\alias{as.ore.numeric,ore-method}
\alias{as.ore.numeric,ore.numeric-method}
\alias{as.ore.character}
\alias{as.ore.character,ANY-method}
\alias{as.ore.character,ore-method}
\alias{as.ore.character,ore.character-method}
\alias{as.ore.factor}
\alias{as.ore.factor,ANY-method}
\alias{as.ore.factor,ore-method}
\alias{as.ore.factor,ore.factor-method}
\alias{as.ore.date}
\alias{as.ore.date,ANY-method}
\alias{as.ore.date,ore.date-method}
\alias{as.ore.datetime}
\alias{as.ore.datetime,ANY-method}
\alias{as.ore.datetime,ore.datetime-method}
\alias{as.ore.difftime}
\alias{as.ore.difftime,ANY-method}
\alias{as.ore.difftime,ore.difftime-method}
\alias{as.ore.frame}
\alias{as.ore.frame,ANY-method}
\alias{as.ore.frame,ore-method}
\alias{as.ore.frame,ore.frame-method}
\alias{as.ore.matrix}
\alias{as.ore.matrix,ANY-method}
\alias{as.ore.matrix,ore-method}
\alias{as.ore.matrix,ore.matrix-method}
\title{Oracle R Enterprise Coercion Functions}
\description{
  Coerces objects to \code{\linkS4class{ore}} class types.
}
\usage{
as.ore(x, ...)
as.ore.vector(x, mode = "any")
as.ore.logical(x, ...)
as.ore.integer(x, ...)
as.ore.numeric(x, ...)
as.ore.character(x, ...)
as.ore.factor(x, ...)
as.ore.date(x, ...)
as.ore.datetime(x, ...)
as.ore.difftime(x, ...)
as.ore.frame(x, ...)
as.ore.matrix(x, ...)
}
\arguments{
  \item{x}{
    An object.
  }
  \item{mode}{
    A character string specifying an atomic mode or \code{"any"}. The
    supported atomic modes are \code{"logical"}, \code{"integer"},
    \code{"numeric"} (synonym \code{"double"}), and \code{"character"}.
  }
  \item{\dots}{
    Additional arguments.
  }
}
\details{
  The \code{as.ore} function coerces in-memory \R objects to
  \code{\linkS4class{ore}} objects. It is similar to the
  \code{\link{ore.push}} function, but whereas \code{\link{ore.push}}
  may not create an \code{\linkS4class{ore}} object if no mapping
  exists, the \code{as.ore} function will throw an error if it cannot
  create an \code{\linkS4class{ore}} object. See \code{\link{ore.push}}
  for more information on the mapping from in-memory \R objects to
  \code{\linkS4class{ore}} objects.
}
\value{
  An \code{\linkS4class{ore}} object.
}
\references{
  \href{http://www.oracle.com/technetwork/database/database-technologies/r/r-enterprise/documentation/index.html}{Oracle R Enterprise}
}
\author{
  Oracle \email{oracle-r-enterprise@oracle.com}
}
\seealso{
  \code{\linkS4class{ore}},
  \code{\link{ore.push}},
  \code{\link{is.ore}},
  \code{\link[base]{as.vector}}
}
\examples{
\dontshow{
if (!interactive())
    ore.connect(user     = Sys.getenv("ORE_USERNAME", "rquser"),
                sid      = Sys.getenv("ORACLE_SID"),
                host     = Sys.getenv("HOST"),
                password = Sys.getenv("ORE_PASSWORD", "rquser"),
                port  = if (.Platform$OS.type == "windows")
                           Sys.getenv("ORACLE_PORT")
                        else
                           Sys.getenv("TCPPORT"),
                all = TRUE)
}

df <- data.frame(A = 1:26, B = letters)
dim(df)
class(df)
oreDF <- as.ore(df)
class(oreDF)
dim(oreDF)
head(oreDF)

vec <- 1:20
class(vec)
oreVec <- as.ore(vec)
class(oreVec)
}
\keyword{classes}
\keyword{database}
\keyword{ORE}