mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-07-01 07:20:20 +02:00
fbbe5fa873
* libguile/fluids-internal.h: Add struct scm_dynamic_state_snapshot definition. * libguile/fluids.h (scm_is_dynamic_state): Inline. * libguile/fluids.c: Use "struct scm_dynamic_state_snapshot".
86 lines
2.9 KiB
C
86 lines
2.9 KiB
C
#ifndef SCM_FLUIDS_H
|
||
#define SCM_FLUIDS_H
|
||
|
||
/* Copyright 1996,2000-2001,2006,2008-2013,2018,2025
|
||
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/error.h>
|
||
#include "libguile/vectors.h"
|
||
|
||
|
||
/* Fluids.
|
||
|
||
Fluids are objects of a certain type that can hold one SCM value per
|
||
dynamic state. That is, modifications to this value are only visible
|
||
to code that executes with the same dynamic state as the modifying
|
||
code. When a new dynamic state is constructed, it inherits the
|
||
values from its parent. Because each thread executes with its own
|
||
dynamic state, you can use fluids for thread local storage.
|
||
*/
|
||
|
||
#define SCM_FLUID_P(x) (SCM_HAS_TYP7 (x, scm_tc7_fluid))
|
||
|
||
static inline int
|
||
scm_is_fluid (SCM x)
|
||
{
|
||
return SCM_FLUID_P (x);
|
||
}
|
||
|
||
#define SCM_VALIDATE_FLUID(pos, fluid) \
|
||
SCM_I_MAKE_VALIDATE_MSG2 (pos, fluid, scm_is_fluid, "fluid")
|
||
|
||
SCM_API SCM scm_make_fluid (void);
|
||
SCM_API SCM scm_make_fluid_with_default (SCM dflt);
|
||
SCM_API SCM scm_make_unbound_fluid (void);
|
||
SCM_API SCM scm_make_thread_local_fluid (SCM dflt);
|
||
SCM_API SCM scm_fluid_p (SCM fl);
|
||
SCM_API SCM scm_fluid_thread_local_p (SCM fluid);
|
||
SCM_API SCM scm_fluid_ref (SCM fluid);
|
||
SCM_API SCM scm_fluid_ref_star (SCM fluid, SCM depth);
|
||
SCM_API SCM scm_fluid_set_x (SCM fluid, SCM value);
|
||
SCM_API SCM scm_fluid_unset_x (SCM fluid);
|
||
SCM_API SCM scm_fluid_bound_p (SCM fluid);
|
||
|
||
SCM_API SCM scm_c_with_fluids (SCM fluids, SCM vals,
|
||
SCM (*cproc)(void *), void *cdata);
|
||
SCM_API SCM scm_c_with_fluid (SCM fluid, SCM val,
|
||
SCM (*cproc)(void *), void *cdata);
|
||
SCM_API SCM scm_with_fluids (SCM fluids, SCM vals, SCM thunk);
|
||
SCM_API SCM scm_with_fluid (SCM fluid, SCM val, SCM thunk);
|
||
|
||
SCM_API void scm_dynwind_fluid (SCM fluid, SCM value);
|
||
|
||
static inline int
|
||
scm_is_dynamic_state (SCM x)
|
||
{
|
||
return SCM_HAS_TYP7 (x, scm_tc7_dynamic_state);
|
||
}
|
||
|
||
SCM_API SCM scm_dynamic_state_p (SCM obj);
|
||
SCM_API int scm_is_dynamic_state (SCM obj);
|
||
SCM_API SCM scm_current_dynamic_state (void);
|
||
SCM_API SCM scm_set_current_dynamic_state (SCM state);
|
||
SCM_API void scm_dynwind_current_dynamic_state (SCM state);
|
||
SCM_API void *scm_c_with_dynamic_state (SCM state,
|
||
void *(*func)(void *), void *data);
|
||
SCM_API SCM scm_with_dynamic_state (SCM state, SCM proc);
|
||
|
||
#endif /* SCM_FLUIDS_H */
|