Guile's application programming interface (API) makes functionality available that an application developer can use in either C or Scheme programming. The interface consists of elements that may be macros, functions or variables in C, and procedures, variables, syntax or other types of object in Scheme.
Many elements are available to both Scheme and C, in a form that is
appropriate. For example, the
assq Scheme procedure is also
scm_assq to C code. These elements are documented
only once, addressing both the Scheme and C aspects of them.
The Scheme name of an element is related to its C name in a regular way. Also, a C function takes its parameters in a systematic way.
Normally, the name of a C function can be derived given its Scheme name, using some simple textual transformations:
?(question mark) with
!(exclamation point) with
<=(less than or equal) with
>=(greater than or equal) with
<(less than) with
>(greater than) with
A C function always takes a fixed number of arguments of type
SCM, even when the corresponding Scheme function takes a
For some Scheme functions, some last arguments are optional; the
corresponding C function must always be invoked with all optional
arguments specified. To get the effect as if an argument has not been
SCM_UNDEFINED as its value. You can not do
this for an argument in the middle; when one argument is
SCM_UNDEFINED all the ones following it must be
SCM_UNDEFINED as well.
Some Scheme functions take an arbitrary number of rest arguments; the corresponding C function must be invoked with a list of all these arguments. This list is always the last argument of the C function.
These two variants can also be combined.
The type of the return value of a C function that corresponds to a
Scheme function is always
SCM. In the descriptions below,
types are therefore often omitted bot for the return value and for the