Availability:C-language interface function
char * PL_record_external(term_t
+t, size_t *len)Record the term t into the Prolog database as recorda/3
and return an opaque handle to the term. The returned handle remains
valid until PL_erase_external()
is called on it. Currently aborts the process with a fatal error
on failure. Future versions may raise a resource exception and return (char*)0.
It is allowed to copy the data and use PL_recorded_external()
on the copy. The user is responsible for the memory management of the
copy. After copying, the original may be discarded using
PL_erase_external().
PL_record_external()
will fail if the term contains blobs that cannot be serialized,
such as streams.
PL_recorded_external()
is used to copy such recorded terms back to the Prolog stack.
