Warning: This is the manual of the legacy Guile 2.2 series. You may want to read the manual of the current stable series instead.
Next: provide and require, Previous: Module System Reflection, Up: Modules [Contents][Index]
The last sections have described how modules are used in Scheme code, which is the recommended way of creating and accessing modules. You can also work with modules from C, but it is more cumbersome.
The following procedures are available.
Call func and make module the current module during the
call. The argument data is passed to func. The return
value of scm_c_call_with_current_module
is the return value of
func.
Find a the variable bound to the symbol name in the public interface of the module named module_name.
module_name should be a list of symbols, when represented as a
Scheme object, or a space-separated string, in the const char *
case. See scm_c_define_module
below, for more examples.
Signals an error if no module was found with the given name. If
name is not bound in the module, just returns #f
.
Like scm_public_variable
, but looks in the internals of the
module named module_name instead of the public interface.
Logically, these procedures should only be called on modules you write.
Like scm_public_variable
or scm_private_variable
, but if
the name is not bound in the module, signals an error. Returns a
variable, always.
static SCM eval_string_var; /* NOTE: It is important that the call to 'my_init' happens-before all calls to 'my_eval_string'. */ void my_init (void) { eval_string_var = scm_c_public_lookup ("ice-9 eval-string", "eval-string"); } SCM my_eval_string (SCM str) { return scm_call_1 (scm_variable_ref (eval_string_var), str); }
Like scm_public_lookup
or scm_private_lookup
, but
additionally dereferences the variable. If the variable object is
unbound, signals an error. Returns the value bound to name in
module_name.
In addition, there are a number of other lookup-related procedures. We
suggest that you use the scm_public_
and scm_private_
family of procedures instead, if possible.
Return the variable bound to the symbol indicated by name in the current module. If there is no such binding or the symbol is not bound to a variable, signal an error.
Like scm_c_lookup
, but the symbol is specified directly.
Like scm_c_lookup
and scm_lookup
, but the specified
module is used instead of the current one.
Like scm_module_lookup
, but if the binding does not exist, just
returns #f
instead of raising an error.
To define a value, use scm_define
:
Bind the symbol indicated by name to a variable in the current module and set that variable to val. When name is already bound to a variable, use that. Else create a new variable.
Like scm_c_define
, but the symbol is specified directly.
Like scm_c_define
and scm_define
, but the specified
module is used instead of the current one.
In some rare cases, you may need to access the variable that
scm_module_define
would have accessed, without changing the
binding of the existing variable, if one is present. In that case, use
scm_module_ensure_local_variable
:
Like scm_module_define
, but if the sym is already locally
bound in that module, the variable’s existing binding is not reset.
Returns a variable.
Find the symbol that is bound to variable in module. When no such binding is found, return #f
.
Define a new module named name and make it current while init is called, passing it data. Return the module.
The parameter name is a string with the symbols that make up the module name, separated by spaces. For example, ‘"foo bar"’ names the module ‘(foo bar)’.
When there already exists a module named name, it is used unchanged, otherwise, an empty module is created.
Find the module name name and return it. When it has not
already been defined, try to auto-load it. When it can’t be found
that way either, create an empty module. The name is interpreted as
for scm_c_define_module
.
Add the module named name to the uses list of the current
module, as with (use-modules name)
. The name is
interpreted as for scm_c_define_module
.
Add the bindings designated by name, ... to the public interface
of the current module. The list of names is terminated by
NULL
.
Next: provide and require, Previous: Module System Reflection, Up: Modules [Contents][Index]