Previous: Included Guile Modules, Up: The Guile module system


5.16.3.7 Accessing Modules from C

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.

— C Procedure: SCM scm_current_module ()

Return the module that is the current module.

— C Procedure: SCM scm_set_current_module (SCM module)

Set the current module to module and return the previous current module.

— C Procedure: SCM scm_c_call_with_current_module (SCM module, SCM (*func)(void *), void *data)

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.

— C Procedure: SCM scm_c_lookup (const char *name)

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.

— C Procedure: SCM scm_lookup (SCM name)

Like scm_c_lookup, but the symbol is specified directly.

— C Procedure: SCM scm_c_module_lookup (SCM module, const char *name)
— C Procedure: SCM scm_module_lookup (SCM module, SCM name)

Like scm_c_lookup and scm_lookup, but the specified module is used instead of the current one.

— C Procedure: SCM scm_c_define (const char *name, SCM val)

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.

— C Procedure: SCM scm_define (SCM name, SCM val)

Like scm_c_define, but the symbol is specified directly.

— C Procedure: SCM scm_c_module_define (SCM module, const char *name, SCM val)
— C Procedure: SCM scm_module_define (SCM module, SCM name, SCM val)

Like scm_c_define and scm_define, but the specified module is used instead of the current one.

— C Procedure: SCM scm_module_reverse_lookup (SCM module, SCM variable)

Find the symbol that is bound to variable in module. When no such binding is found, return #f.

— C Procedure: SCM scm_c_define_module (const char *name, void (*init)(void *), void *data)

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.

— C Procedure: SCM scm_c_resolve_module (const char *name)

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.

— C Procedure: SCM scm_resolve_module (SCM name)

Like scm_c_resolve_module, but the name is given as a real list of symbols.

— C Procedure: SCM scm_c_use_module (const char *name)

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.

— C Procedure: SCM scm_c_export (const char *name, ...)

Add the bindings designated by name, ... to the public interface of the current module. The list of names is terminated by NULL.