diff options
Diffstat (limited to 'libguile/throw.h')
-rw-r--r-- | libguile/throw.h | 99 |
1 files changed, 99 insertions, 0 deletions
diff --git a/libguile/throw.h b/libguile/throw.h new file mode 100644 index 000000000..ea206f900 --- /dev/null +++ b/libguile/throw.h @@ -0,0 +1,99 @@ +#ifndef SCM_THROW_H +#define SCM_THROW_H + +/* Copyright 1995-1996,1998,2000,2006,2008,2010,2014,2017-2018 + Free Software Foundation, Inc. + + This file is part of Guile. + + Guile is free software: you can redistribute it and/or modify it + under the terms of the GNU Lesser General Public License as published + by the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + Guile is distributed in the hope that it will be useful, but WITHOUT + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public + License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with Guile. If not, see + <https://www.gnu.org/licenses/>. */ + + + +#include "libguile/scm.h" + + + +typedef SCM (*scm_t_catch_body) (void *data); +typedef SCM (*scm_t_catch_handler) (void *data, + SCM tag, SCM throw_args); + +SCM_INTERNAL SCM scm_i_make_catch_body_closure (scm_t_catch_body body, + void *body_data); +SCM_INTERNAL SCM scm_i_make_catch_handler_closure (scm_t_catch_handler h, + void *handler_data); + +SCM_API SCM scm_c_catch (SCM tag, + scm_t_catch_body body, + void *body_data, + scm_t_catch_handler handler, + void *handler_data, + scm_t_catch_handler pre_unwind_handler, + void *pre_unwind_handler_data); + +SCM_API SCM scm_c_with_throw_handler (SCM tag, + scm_t_catch_body body, + void *body_data, + scm_t_catch_handler handler, + void *handler_data, + int lazy_catch_p); + +SCM_API SCM scm_internal_catch (SCM tag, + scm_t_catch_body body, + void *body_data, + scm_t_catch_handler handler, + void *handler_data); + +/* The first argument to scm_body_thunk should be a pointer to one of + these. See the implementation of catch in throw.c. */ +struct scm_body_thunk_data +{ + /* The tag being caught. We only use it to figure out what + arguments to pass to the body procedure; see scm_catch_thunk_body for + details. */ + SCM tag; + + /* The Scheme procedure object constituting the catch body. + scm_body_by_proc invokes this. */ + SCM body_proc; +}; + +SCM_API SCM scm_body_thunk (void *); + + +SCM_API SCM scm_handle_by_proc (void *, SCM, SCM); +SCM_API SCM scm_handle_by_proc_catching_all (void *, SCM, SCM); +SCM_API SCM scm_handle_by_message (void *, SCM, SCM); +SCM_API SCM scm_handle_by_message_noexit (void *, SCM, SCM); +SCM_API SCM scm_handle_by_throw (void *, SCM, SCM); +SCM_API int scm_exit_status (SCM args); + +SCM_API SCM scm_catch_with_pre_unwind_handler (SCM tag, SCM thunk, SCM handler, SCM lazy_handler); +SCM_API SCM scm_catch (SCM tag, SCM thunk, SCM handler); +SCM_API SCM scm_with_throw_handler (SCM tag, SCM thunk, SCM handler); +SCM_API SCM scm_ithrow (SCM key, SCM args, int no_return) SCM_NORETURN; + +/* This throws to the `stack-overflow' key, without running pre-unwind + handlers. */ +SCM_API void scm_report_stack_overflow (void); + +/* This throws to the `out-of-memory' key, without running pre-unwind + handlers. */ +SCM_API void scm_report_out_of_memory (void); + +SCM_API SCM scm_throw (SCM key, SCM args) SCM_NORETURN; +SCM_INTERNAL void scm_init_throw (void); + +#endif /* SCM_THROW_H */ |