Skip to content

Retrieves a change from the document's history by its unique hash identifier. The hash is typically obtained from am_get_heads() or am_change_hash().

Usage

am_get_change_by_hash(doc, hash)

Arguments

doc

An Automerge document

hash

A raw vector containing the change hash (must be exactly 32 bytes)

Value

An am_change object, or NULL if the change hash is not found in the document.

Examples

doc <- am_create()
doc$key <- "value"
am_commit(doc, "Add key")

# Get the current heads (change hashes)
heads <- am_get_heads(doc)
head_hash <- heads[[1]]

# Retrieve the change by its hash
change <- am_get_change_by_hash(doc, head_hash)
change
#> <Automerge Change>
#> Hash: 1e d2 ac 7d ...
#> Message: Add key 
am_change_message(change)  # "Add key"
#> [1] "Add key"

am_close(doc)