c('PL_raise_exception')

Documentation
- Reference manual
  - Foreign Language Interface
    - The Foreign Include File
      - Prolog exceptions in foreign code
        
        PL_raise_exception()
        
        PL_throw()
        
        PL_exception()
        
        PL_clear_exception()
- Packages

Availability:C-language interface function

int PL_raise_exception(term_t exception)

Generate an exception (as throw/1) and return FALSE. Below is an example returning an exception from a foreign predicate:

foreign_t
pl_hello(term_t to)
{ char *s;

  if ( PL_get_atom_chars(to, &s) )
  { Sprintf("Hello \"%s\"\n", s);

    PL_succeed;
  } else
  { term_t except = PL_new_term_ref();

    PL_unify_term(except,
                  PL_FUNCTOR_CHARS, "type_error", 2,
                    PL_CHARS, "atom",
                    PL_TERM, to);

    return PL_raise_exception(except);
  }
}