recorda/3

Synopsis

recorda(+Key, +Term, -Ref)

records the Term in the internal database as the first item for the key Key; a database reference to the newly-recorded term is returned in Ref.

Arguments

Key atomic

Term term

Ref db_reference

Description

If Key is a compound term, only its principal functor is significant. That is, foo(1) represents the same key as foo(n).

Exceptions

instantiation_error

Key is not instantiated

range_error

Ref is not a database reference or an unbound variable

See Also

recorded/3, recordz/3, current_key/2 ref-mdb-bas