automerge (version 0.2.1)

am_get_changes: 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)

Value

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

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().

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)