X-Git-Url: http://git.hcoop.net/bpt/guile.git/blobdiff_plain/0527e6876338ba394366273351105d6622368da2..6570cfdfd83b0d792f6ff01594915f3ec1336b16:/libguile/throw.h diff --git a/libguile/throw.h b/libguile/throw.h dissimilarity index 79% index 6b6b3d79c..e2da73170 100644 --- a/libguile/throw.h +++ b/libguile/throw.h @@ -1,112 +1,101 @@ -/* classes: h_files */ - -#ifndef SCM_THROW_H -#define SCM_THROW_H - -/* Copyright (C) 1995,1996,1998,2000 Free Software Foundation, Inc. - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2, or (at your option) - * any later version. - * - * This program 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 General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this software; see the file COPYING. If not, write to - * the Free Software Foundation, Inc., 59 Temple Place, Suite 330, - * Boston, MA 02111-1307 USA - * - * As a special exception, the Free Software Foundation gives permission - * for additional uses of the text contained in its release of GUILE. - * - * The exception is that, if you link the GUILE library with other files - * to produce an executable, this does not by itself cause the - * resulting executable to be covered by the GNU General Public License. - * Your use of that executable is in no way restricted on account of - * linking the GUILE library code into it. - * - * This exception does not however invalidate any other reasons why - * the executable file might be covered by the GNU General Public License. - * - * This exception applies only to the code released by the - * Free Software Foundation under the name GUILE. If you copy - * code from other Free Software Foundation releases into a copy of - * GUILE, as the General Public License permits, the exception does - * not apply to the code that you add in this way. To avoid misleading - * anyone as to the status of such modified files, you must delete - * this exception notice from them. - * - * If you write modifications of your own for GUILE, it is your choice - * whether to permit this exception to apply to your modifications. - * If you do not wish that, delete this exception notice. */ - - - -#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); - -extern SCM scm_internal_catch (SCM tag, - scm_t_catch_body body, - void *body_data, - scm_t_catch_handler handler, - void *handler_data); - -extern SCM scm_internal_lazy_catch (SCM tag, - scm_t_catch_body body, - void *body_data, - scm_t_catch_handler handler, - void *handler_data); - -extern SCM scm_internal_stack_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; -}; - -extern SCM scm_body_thunk (void *); - - -extern SCM scm_handle_by_proc (void *, SCM, SCM); -extern SCM scm_handle_by_proc_catching_all (void *, SCM, SCM); -extern SCM scm_handle_by_message (void *, SCM, SCM); -extern SCM scm_handle_by_message_noexit (void *, SCM, SCM); -extern SCM scm_handle_by_throw (void *, SCM, SCM); -extern int scm_exit_status (SCM args); - -extern SCM scm_catch (SCM tag, SCM thunk, SCM handler); -extern SCM scm_lazy_catch (SCM tag, SCM thunk, SCM handler); -extern SCM scm_ithrow (SCM key, SCM args, int noreturn); - -extern SCM scm_throw (SCM key, SCM args); -extern void scm_init_throw (void); - -#endif /* SCM_THROW_H */ - -/* - Local Variables: - c-file-style: "gnu" - End: -*/ +/* classes: h_files */ + +#ifndef SCM_THROW_H +#define SCM_THROW_H + +/* Copyright (C) 1995,1996,1998,2000, 2006, 2008, 2010, 2014 Free Software Foundation, Inc. + * + * This library 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. + * + * This library 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301 USA + */ + + + +#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_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); + +/* 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_INTERNAL void scm_init_throw (void); + +#endif /* SCM_THROW_H */ + +/* + Local Variables: + c-file-style: "gnu" + End: +*/