Get changes since specified heads — am_get

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.

Value

A list of am_change objects.

Details

Changes are returned as am_change objects that can be inspected with am_change_hash(), am_change_message(), etc., serialized with am_change_to_bytes(), or 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)
all_changes
#> [[1]]
#> <Automerge Change>
#> Hash: e7 8e fb 53 ...
#> 

am_close(doc)