fetch: Fetch Data from a Shared Object

In shard: Deterministic, Zero-Copy Parallel Execution for R

Fetch Data from a Shared Object

Description

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.

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.

Value

The original R object that was shared.

Examples

x <- 1:100
shared <- share(x)
recovered <- fetch(shared)
identical(x, recovered)
close(shared)

shard documentation built on April 3, 2026, 9:08 a.m.