GNU Info

(guile.info)A Portable C to Scheme Interface

---

Next: gh preliminaries Prev: Guile Scripting Up: Top

---

Enter node , (file) or (file)node

A Portable C to Scheme Interface
********************************

The Guile interpreter is based on Aubrey Jaffer's _SCM_ interpreter
(Note: SCM.) with some
modifications to make it suitable as an embedded interpreter, and
further modifications as Guile evolves.

Part of the modification has been to provide a restricted interface to
limit access to the SCM internals; this is called the `gh_' interface,
or _libguile_ interface.

If you are _programming with Guile_, you should only use the C
subroutines described in this manual, which all begin with `gh_'.

If instead you are _extending Guile_, you have the entire SCM source to
play with.  This manual will not help you at all, but you can consult
Aubrey Jaffer's SCM manual (Note: SCM
(scm)Internals.).

If you are _adding a module to Guile_, I recommend that you stick to
the `gh_' interface: this interface is guaranteed to not change
drastically, while the SCM internals might change as Guile is developed.

gh preliminaries

Data types and constants defined by gh

Starting and controlling the interpreter

Error messages

Executing Scheme code

Defining new Scheme procedures in C

Converting data between C and Scheme

Type predicates

Equality predicates

Memory allocation and garbage collection

Calling Scheme procedures from C

Mixing gh and scm APIs