QP_toplevel()

Synopsis

     #include <quintus/quintus.h>
     
     int QP_toplevel()
     

Description

Invokes Prolog's default top level read-prove loop.

For runtime systems, QP_toplevel() immediately transfers control to the definition of the Prolog predicate runtime_entry/1.

QP_toplevel() takes no arguments. QP_query() and related predicates should be used for calling specific Prolog predicates.

One of the effects of calling this function is that the default signal handling for Prolog is enabled. Upon return, the old signal handlers are restored.

The built-in predicate break/0 calls this function. Nested calls to this function are equivalent to calling the Prolog predicate break/0.

This function returns when an end-of-file character is read.

Return Value

QP_SUCCESS

QP_FAILURE

QP_ERROR

See Also

QP_initialize(), break/0.