mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-06-07 12:40:19 +02:00
464ec999de
This header file turns out to only have internal details. Users that need introspection can use Scheme. * libguile/programs.h (SCM_PROGRAM_P, SCM_PROGRAM_CODE) (SCM_PROGRAM_FREE_VARIABLES, SCM_PROGRAM_FREE_VARIABLE_REF) (SCM_PROGRAM_FREE_VARIABLE_SET, SCM_PROGRAM_NUM_FREE_VARIABLES) (SCM_VALIDATE_PROGRAM, SCM_F_PROGRAM_IS_BOOT, SCM_F_PROGRAM_IS_PRIMITIVE) (SCM_F_PROGRAM_IS_PRIMITIVE_GENERIC, SCM_F_PROGRAM_IS_CONTINUATION) (SCM_F_PROGRAM_IS_PARTIAL_CONTINUATION, SCM_F_PROGRAM_IS_FOREIGN) (SCM_PROGRAM_IS_BOOT, SCM_PROGRAM_IS_PRIMITIVE) (SCM_PROGRAM_IS_PRIMITIVE_GENERIC, SCM_PROGRAM_IS_CONTINUATION) (SCM_PROGRAM_IS_PARTIAL_CONTINUATION, SCM_PROGRAM_IS_FOREIGN): Remove these macros, as we are making this whole API private. (struct scm_program, scm_is_program, scm_to_program, scm_from_program) (scm_program_flags, scm_program_is_boot, scm_program_is_primitive) (scm_program_is_primitive_generic, scm_program_is_continuation) (scm_program_is_partial_continuation, scm_program_is_foreign) (scm_program_code, scm_program_free_variable_count) (scm_program_free_variable_ref, scm_program_free_variable_set_x) (scm_i_make_program): New inline functions. * libguile/Makefile.am (noinst_HEADERS): Add programs.h; no longer installed. It was never directly included from libguile.h. * libguile/continuations.c: * libguile/continuations.h: * libguile/control.c: * libguile/foreign.c: * libguile/frames.c: * libguile/frames.h: * libguile/goops.c: * libguile/gsubr.c: * libguile/gsubr.h: * libguile/intrinsics.h: * libguile/procprop.c: * libguile/procs.c: * libguile/programs.c: * libguile/stacks.c: * libguile/vm-engine.c: * libguile/vm.c: * libguile/vm.h: Adapt all users.
160 lines
5.3 KiB
C
160 lines
5.3 KiB
C
#ifndef SCM_GSUBR_H
|
||
#define SCM_GSUBR_H
|
||
|
||
/* Copyright 1995-1996,1998,2000-2001,2006,2008,2009-2011,2013,2015,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/snarf.h"
|
||
|
||
|
||
|
||
|
||
|
||
/* Subrs
|
||
*/
|
||
|
||
/* Max number of args to the C procedure backing a gsubr */
|
||
#define SCM_GSUBR_MAX 10
|
||
|
||
#define SCM_PRIMITIVE_P(x) (scm_is_primitive (x))
|
||
#define SCM_PRIMITIVE_GENERIC_P(x) (scm_is_primitive_generic (x))
|
||
|
||
#define SCM_SUBRF(x) scm_subr_function (x)
|
||
#define SCM_SUBR_NAME(x) scm_subr_name (x)
|
||
|
||
|
||
|
||
struct scm_program;
|
||
|
||
SCM_INTERNAL uint32_t *
|
||
scm_i_alloc_primitive_code_with_instrumentation (size_t uint32_count,
|
||
uint32_t **write_ptr);
|
||
SCM_INTERNAL int scm_i_primitive_code_p (const uint32_t *code);
|
||
SCM_INTERNAL uintptr_t scm_i_primitive_call_ip (struct scm_program *subr);
|
||
SCM_INTERNAL SCM scm_i_primitive_name (const uint32_t *code);
|
||
|
||
SCM_INTERNAL int scm_is_primitive (SCM x);
|
||
SCM_INTERNAL int scm_is_primitive_generic (SCM x);
|
||
|
||
SCM_API scm_t_subr scm_subr_function (SCM subr);
|
||
SCM_INTERNAL scm_t_subr scm_subr_function_by_index (uint32_t subr_idx);
|
||
SCM_API SCM scm_subr_name (SCM subr);
|
||
SCM_INTERNAL SCM* scm_subr_generic (SCM x);
|
||
SCM_INTERNAL void scm_set_subr_generic (SCM x, SCM g);
|
||
|
||
SCM_INTERNAL SCM scm_apply_subr (union scm_vm_stack_element *sp,
|
||
uint32_t subr_idx, ptrdiff_t nargs);
|
||
|
||
SCM_API SCM scm_c_make_gsubr (const char *name,
|
||
int req, int opt, int rst, scm_t_subr fcn);
|
||
SCM_API SCM scm_c_make_gsubr_with_generic (const char *name,
|
||
int req, int opt, int rst,
|
||
scm_t_subr fcn, SCM *gf);
|
||
SCM_API SCM scm_c_define_gsubr (const char *name,
|
||
int req, int opt, int rst, scm_t_subr fcn);
|
||
SCM_API SCM scm_c_define_gsubr_with_generic (const char *name,
|
||
int req, int opt, int rst,
|
||
scm_t_subr fcn, SCM *gf);
|
||
|
||
|
||
|
||
/* Casting to a function that can take any number of arguments. */
|
||
#define SCM_FUNC_CAST_ARBITRARY_ARGS scm_t_subr
|
||
|
||
#define SCM_DEFINE_GSUBR(FNAME, PRIMNAME, REQ, OPT, VAR, ARGLIST, DOCSTRING) \
|
||
SCM_SNARF_HERE(\
|
||
SCM_UNUSED static const char s_ ## FNAME [] = PRIMNAME; \
|
||
SCM FNAME ARGLIST\
|
||
)\
|
||
SCM_SNARF_INIT(\
|
||
scm_c_define_gsubr (s_ ## FNAME, REQ, OPT, VAR, \
|
||
(SCM_FUNC_CAST_ARBITRARY_ARGS) FNAME); \
|
||
)\
|
||
SCM_SNARF_DOCS(primitive, FNAME, PRIMNAME, ARGLIST, REQ, OPT, VAR, DOCSTRING)
|
||
|
||
/* Always use the generic subr case. */
|
||
#define SCM_DEFINE SCM_DEFINE_GSUBR
|
||
|
||
#define SCM_PRIMITIVE_GENERIC(FNAME, PRIMNAME, REQ, OPT, VAR, ARGLIST, DOCSTRING) \
|
||
SCM_SNARF_HERE(\
|
||
SCM_UNUSED static const char s_ ## FNAME [] = PRIMNAME; \
|
||
static SCM g_ ## FNAME; \
|
||
SCM FNAME ARGLIST\
|
||
)\
|
||
SCM_SNARF_INIT(\
|
||
g_ ## FNAME = SCM_PACK (0); \
|
||
scm_c_define_gsubr_with_generic (s_ ## FNAME, REQ, OPT, VAR, \
|
||
(SCM_FUNC_CAST_ARBITRARY_ARGS) FNAME, \
|
||
&g_ ## FNAME); \
|
||
)\
|
||
SCM_SNARF_DOCS(primitive, FNAME, PRIMNAME, ARGLIST, REQ, OPT, VAR, DOCSTRING)
|
||
|
||
#define SCM_DEFINE_PUBLIC(FNAME, PRIMNAME, REQ, OPT, VAR, ARGLIST, DOCSTRING) \
|
||
SCM_SNARF_HERE(\
|
||
SCM_UNUSED static const char s_ ## FNAME [] = PRIMNAME; \
|
||
SCM FNAME ARGLIST\
|
||
)\
|
||
SCM_SNARF_INIT(\
|
||
scm_c_define_gsubr (s_ ## FNAME, REQ, OPT, VAR, \
|
||
(SCM_FUNC_CAST_ARBITRARY_ARGS) FNAME); \
|
||
scm_c_export (s_ ## FNAME, NULL); \
|
||
)\
|
||
SCM_SNARF_DOCS(primitive, FNAME, PRIMNAME, ARGLIST, REQ, OPT, VAR, DOCSTRING)
|
||
|
||
#define SCM_DEFINE_STATIC(FNAME, PRIMNAME, REQ, OPT, VAR, ARGLIST, DOCSTRING) \
|
||
SCM_SNARF_HERE(\
|
||
static const char s_ ## FNAME [] = PRIMNAME; \
|
||
static SCM FNAME ARGLIST\
|
||
)\
|
||
SCM_SNARF_INIT(\
|
||
scm_c_define_gsubr (s_ ## FNAME, REQ, OPT, VAR, \
|
||
(SCM_FUNC_CAST_ARBITRARY_ARGS) FNAME); \
|
||
)\
|
||
SCM_SNARF_DOCS(primitive, FNAME, PRIMNAME, ARGLIST, REQ, OPT, VAR, DOCSTRING)
|
||
|
||
#define SCM_PROC(RANAME, STR, REQ, OPT, VAR, CFN) \
|
||
SCM_SNARF_HERE(SCM_UNUSED static const char RANAME[]=STR) \
|
||
SCM_SNARF_INIT(scm_c_define_gsubr (RANAME, REQ, OPT, VAR, \
|
||
(SCM_FUNC_CAST_ARBITRARY_ARGS) CFN))
|
||
|
||
#define SCM_REGISTER_PROC(RANAME, STR, REQ, OPT, VAR, CFN) \
|
||
SCM_SNARF_HERE(SCM_UNUSED static const char RANAME[]=STR) \
|
||
SCM_SNARF_INIT(scm_c_define_gsubr (RANAME, REQ, OPT, VAR, \
|
||
(SCM_FUNC_CAST_ARBITRARY_ARGS) CFN);) \
|
||
SCM_SNARF_DOCS(register, CFN, STR, (), REQ, OPT, VAR, \
|
||
"implemented by the C function \"" #CFN "\"")
|
||
|
||
#define SCM_GPROC(RANAME, STR, REQ, OPT, VAR, CFN, GF) \
|
||
SCM_SNARF_HERE(\
|
||
SCM_UNUSED static const char RANAME[]=STR;\
|
||
static SCM GF \
|
||
)SCM_SNARF_INIT(\
|
||
GF = SCM_PACK (0); /* Dirk:FIXME:: Can we safely use #f instead of 0? */ \
|
||
scm_c_define_gsubr_with_generic (RANAME, REQ, OPT, VAR, \
|
||
(SCM_FUNC_CAST_ARBITRARY_ARGS) CFN, &GF) \
|
||
)
|
||
|
||
|
||
|
||
|
||
SCM_INTERNAL void scm_init_gsubr (void);
|
||
|
||
#endif /* SCM_GSUBR_H */
|