Skip to contents

Fetch Data from a Shared Object

Source: R/share.R
fetch.Rd

Retrieves the R object from shared memory by deserializing it. This is the primary way to access shared data in workers.

Usage

fetch(x, ...)

# S3 method for class 'shard_shared'
fetch(x, ...)

# S3 method for class 'shard_deep_shared'
fetch(x, ...)

# Default S3 method
fetch(x, ...)

Arguments

x

A shard_shared object.

...

Ignored.

Value

The original R object that was shared.

Details

When called in the main process, this reads from the existing segment. When called in a worker process, this opens the segment by path and deserializes the data.

The fetch() function is the primary way to access shared data. It can also be called as materialize() for compatibility.

Examples

# \donttest{
x <- 1:100
shared <- share(x)
recovered <- fetch(shared)
identical(x, recovered)
#> [1] FALSE
close(shared)
# }