Availability:C-language interface function
int PL_cut_query(qid_t
qid)Discards the query, but does not delete any of the data created by the
query. It just invalidates qid, allowing for a new call to
PL_open_query()
in this context. PL_cut_query()
may invoke cleanup handlers (see setup_call_cleanup/3)
and therefore may experience exceptions. If an exception occurs the
return value is FALSE and the exception is accessible
through PL_exception(0).