11.3.187 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, must be nonvar

Term

term

Ref

db_reference, must be var

Description

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

Any uninstantiated variables in the Term will be replaced by new private variables, along with copies of any subgoals blocked on these variables (see ref-sem-sec).

Exceptions

instantiation_error

Key is not instantiated

uninstantiation_error

Ref is not a variable

Examples

See Also

ref-mdb-idb.