am_get_changes: Get changes since specified heads

In automerge: R Bindings for 'Automerge' 'CRDT' Library

Get changes since specified heads

Description

Returns all changes that have been made to the document since the specified heads. If heads is NULL, returns all changes in the document's history.

Usage

am_get_changes(doc, heads = NULL)

Arguments

doc	An Automerge document
heads	A list of raw vectors (change hashes) returned by am_get_heads(), or NULL to get all changes.

Details

Changes are returned as serialized raw vectors that can be transmitted over the network and applied to other documents using am_apply_changes().

Value

A list of raw vectors, each containing a serialized change.

Examples

doc <- am_create()
am_put(doc, AM_ROOT, "x", 1)
am_commit(doc)

# Get all changes
all_changes <- am_get_changes(doc, NULL)
cat("Document has", length(all_changes), "change(s)\n")

am_close(doc)

automerge documentation built on Feb. 5, 2026, 5:08 p.m.