diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-21 11:54:28 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-21 11:54:28 +0000 |
commit | e6918187568dbd01842d8d1d2c808ce16a894239 (patch) | |
tree | 64f88b554b444a49f656b6c656111a145cbbaa28 /src/arrow/r/man/write_ipc_stream.Rd | |
parent | Initial commit. (diff) | |
download | ceph-e6918187568dbd01842d8d1d2c808ce16a894239.tar.xz ceph-e6918187568dbd01842d8d1d2c808ce16a894239.zip |
Adding upstream version 18.2.2.upstream/18.2.2
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'src/arrow/r/man/write_ipc_stream.Rd')
-rw-r--r-- | src/arrow/r/man/write_ipc_stream.Rd | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/src/arrow/r/man/write_ipc_stream.Rd b/src/arrow/r/man/write_ipc_stream.Rd new file mode 100644 index 000000000..2f215f25f --- /dev/null +++ b/src/arrow/r/man/write_ipc_stream.Rd @@ -0,0 +1,45 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/deprecated.R, R/ipc_stream.R +\name{write_arrow} +\alias{write_arrow} +\alias{write_ipc_stream} +\title{Write Arrow IPC stream format} +\usage{ +write_arrow(x, sink, ...) + +write_ipc_stream(x, sink, ...) +} +\arguments{ +\item{x}{\code{data.frame}, \link{RecordBatch}, or \link{Table}} + +\item{sink}{A string file path, URI, or \link{OutputStream}, or path in a file +system (\code{SubTreeFileSystem})} + +\item{...}{extra parameters passed to \code{write_feather()}.} +} +\value{ +\code{x}, invisibly. +} +\description{ +Apache Arrow defines two formats for \href{https://arrow.apache.org/docs/format/Columnar.html#serialization-and-interprocess-communication-ipc}{serializing data for interprocess communication (IPC)}: +a "stream" format and a "file" format, known as Feather. \code{write_ipc_stream()} +and \code{\link[=write_feather]{write_feather()}} write those formats, respectively. +} +\details{ +\code{write_arrow()}, a wrapper around \code{write_ipc_stream()} and \code{write_feather()} +with some nonstandard behavior, is deprecated. You should explicitly choose +the function that will write the desired IPC format (stream or file) since +either can be written to a file or \code{OutputStream}. +} +\examples{ +\dontshow{if (arrow_available()) (if (getRversion() >= "3.4") withAutoprint else force)(\{ # examplesIf} +tf <- tempfile() +on.exit(unlink(tf)) +write_ipc_stream(mtcars, tf) +\dontshow{\}) # examplesIf} +} +\seealso{ +\code{\link[=write_feather]{write_feather()}} for writing IPC files. \code{\link[=write_to_raw]{write_to_raw()}} to +serialize data to a buffer. +\link{RecordBatchWriter} for a lower-level interface. +} |