microscheme/scheme.h

/*
 * µscheme
 *
 * Copyright (C) 2015 Marc Alexander Lehmann <uscheme@schmorp.de>
 *                 do as you want with this, attribution appreciated.
 */

/* SCHEME.H */

#ifndef SCHEME_H
#define SCHEME_H

#include <inttypes.h>
#include <stdio.h>

#ifdef __cplusplus
extern "C"
{
#endif

/*
 * Default values for #define'd symbols
 */
#ifndef STANDALONE             /* If used as standalone interpreter */
# define STANDALONE 1
#endif

#define SCHEME_EXPORT static

#if USE_NO_FEATURES
# define USE_MULTIPLICITY 0
# define USE_MATH 0
# define USE_CHAR_CLASSIFIERS 0
# define USE_ASCII_NAMES 0
# define USE_PORTS 1
# define USE_STRING_PORTS 0
# define USE_ERROR_HOOK 0
# define USE_TRACING 0
# define USE_COLON_HOOK 0
# define USE_DL 0
# define USE_PLIST 0
# define USE_REAL 0
# define USE_ERROR_CHECKING 0
# define USE_PRINTF 0
#endif

/*
 * Define: much slower, but somewhat smaller evaluation stack implemention, use more memory
 * Undefined: faster, somewhat bigger implementation, uses less memory at runtime
 */
/*#define USE_SCHEME_STACK*/

#ifndef USE_MULTIPLICITY
# define USE_MULTIPLICITY 1
#endif

#ifndef USE_REAL
# define USE_REAL 1
#endif

#ifndef USE_MATH               /* If math support is needed */
# define USE_MATH 1
#endif

#ifndef USE_CHAR_CLASSIFIERS   /* If char classifiers are needed */
# define USE_CHAR_CLASSIFIERS 1
#endif

#ifndef USE_ASCII_NAMES        /* If extended escaped characters are needed */
# define USE_ASCII_NAMES 1
#endif

#ifndef USE_PORTS              /* Enable ports */
# define USE_PORTS 1
#endif

#ifndef USE_STRING_PORTS       /* Enable string ports */
# define USE_STRING_PORTS USE_PORTS
#endif

#ifndef USE_TRACING
# define USE_TRACING 1
#endif

#ifndef USE_PLIST
# define USE_PLIST 0
#endif

/* To force system errors through user-defined error handling (see *error-hook*) */
#ifndef USE_ERROR_HOOK
# define USE_ERROR_HOOK 1
#endif

#ifndef USE_COLON_HOOK         /* Enable qualified qualifier */
# define USE_COLON_HOOK 1
#endif

#ifndef USE_ERROR_CHECKING
# define USE_ERROR_CHECKING 1
#endif

#ifndef USE_PRINTF
# define USE_PRINTF 1
#endif

#ifndef USE_IGNORECASE
# define USE_IGNORECASE 1
#endif

#ifndef SHOW_ERROR_LINE        /* Show error line in file */
# define SHOW_ERROR_LINE 1
#endif

#if !USE_REAL
# undef USE_MATH
# define USE_MATH 0
#endif

#if USE_MULTIPLICITY
# define SCHEME_V sc
# define SCHEME_P scheme *SCHEME_V
# define SCHEME_P_ SCHEME_P,
# define SCHEME_A SCHEME_V
# define SCHEME_A_ SCHEME_A,
#else
# define SCHEME_V (&sc)
# define SCHEME_P
# define SCHEME_P_
# define SCHEME_A
# define SCHEME_A_
#endif

typedef struct scheme scheme;
typedef struct cell *pointer;

typedef long IVALUE;          /* this is not used consistently yet */
#if USE_REAL
typedef double RVALUE;
#else
typedef long RVALUE;
#endif

/* Used for documentation purposes, to signal functions in 'interface' */
#define INTERFACE static

SCHEME_EXPORT scheme *scheme_init_new ();
SCHEME_EXPORT int scheme_init (SCHEME_P);
SCHEME_EXPORT void scheme_deinit (SCHEME_P);
void scheme_set_input_port_file (SCHEME_P_ int fin);
void scheme_set_input_port_string (SCHEME_P_ char *start, char *past_the_end);
SCHEME_EXPORT void scheme_set_output_port_file (SCHEME_P_ int fin);
void scheme_set_output_port_string (SCHEME_P_ char *start, char *past_the_end);
SCHEME_EXPORT void scheme_load_file (SCHEME_P_ int fin);
SCHEME_EXPORT void scheme_load_named_file (SCHEME_P_ int fin, const char *filename);
SCHEME_EXPORT void scheme_load_string (SCHEME_P_ const char *cmd);
SCHEME_EXPORT pointer scheme_apply0 (SCHEME_P_ const char *procname);
SCHEME_EXPORT pointer scheme_call (SCHEME_P_ pointer func, pointer args);
SCHEME_EXPORT pointer scheme_eval (SCHEME_P_ pointer obj);
void scheme_set_external_data (SCHEME_P_ void *p);
SCHEME_EXPORT void scheme_define (SCHEME_P_ pointer env, pointer symbol, pointer value);

typedef pointer (*foreign_func) (SCHEME_P_ pointer);

pointer xcons (SCHEME_P_ pointer a, pointer b, int immutable);
INTERFACE pointer mk_integer (SCHEME_P_ IVALUE n);
INTERFACE pointer mk_real (SCHEME_P_ RVALUE n);
INTERFACE pointer mk_symbol (SCHEME_P_ const char *name);
INTERFACE pointer gensym (SCHEME_P);
INTERFACE pointer mk_string (SCHEME_P_ const char *str);
INTERFACE pointer mk_counted_string (SCHEME_P_ const char *str, uint32_t len);
INTERFACE pointer mk_empty_string (SCHEME_P_ uint32_t len, char fill);
INTERFACE pointer mk_character (SCHEME_P_ int c);
INTERFACE pointer mk_foreign_func (SCHEME_P_ foreign_func f);
INTERFACE void putstr (SCHEME_P_ const char *s);
INTERFACE int list_length (SCHEME_P_ pointer a);
INTERFACE int eqv (pointer a, pointer b);

#if !STANDALONE
typedef struct scheme_registerable
{
  foreign_func f;
  const char *name;
} scheme_registerable;

void scheme_register_foreign_func_list (SCHEME_P_ scheme_registerable * list, int n);
#endif                         /* !STANDALONE */

#ifdef __cplusplus
}
#endif

#endif

/*
Local variables:
c-file-style: "k&r"
End:
*/
Revision:	1.7
Committed:	Sat Nov 28 05:12:53 2015 UTC (8 years, 6 months ago) by root
Content type:	text/plain
Branch:	MAIN
Changes since 1.6:	+2 -33 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.5	/*
2			* µscheme
3			*
4			* Copyright (C) 2015 Marc Alexander Lehmann <uscheme@schmorp.de>
5			* do as you want with this, attribution appreciated.
6			*/
7	root	1.1
8			/* SCHEME.H */
9
10			#ifndef SCHEME_H
11	root	1.2	#define SCHEME_H
12	root	1.1
13	root	1.3	#include <inttypes.h>
14	root	1.2	#include <stdio.h>
15	root	1.1
16	root	1.2	#ifdef __cplusplus
17	root	1.1	extern "C"
18			{
19	root	1.2	#endif
20	root	1.1
21			/*
22			* Default values for #define'd symbols
23			*/
24	root	1.2	#ifndef STANDALONE /* If used as standalone interpreter */
25			# define STANDALONE 1
26			#endif
27
28			#define SCHEME_EXPORT static
29
30			#if USE_NO_FEATURES
31			# define USE_MULTIPLICITY 0
32			# define USE_MATH 0
33			# define USE_CHAR_CLASSIFIERS 0
34			# define USE_ASCII_NAMES 0
35			# define USE_PORTS 1
36			# define USE_STRING_PORTS 0
37			# define USE_ERROR_HOOK 0
38			# define USE_TRACING 0
39			# define USE_COLON_HOOK 0
40			# define USE_DL 0
41			# define USE_PLIST 0
42	root	1.5	# define USE_REAL 0
43	root	1.2	# define USE_ERROR_CHECKING 0
44			# define USE_PRINTF 0
45			#endif
46	root	1.1
47			/*
48	root	1.4	* Define: much slower, but somewhat smaller evaluation stack implemention, use more memory
49			* Undefined: faster, somewhat bigger implementation, uses less memory at runtime
50	root	1.1	*/
51	root	1.4	/#define USE_SCHEME_STACK/
52	root	1.2
53			#ifndef USE_MULTIPLICITY
54			# define USE_MULTIPLICITY 1
55			#endif
56
57	root	1.5	#ifndef USE_REAL
58			# define USE_REAL 1
59	root	1.2	#endif
60	root	1.1
61	root	1.2	#ifndef USE_MATH /* If math support is needed */
62			# define USE_MATH 1
63			#endif
64
65			#ifndef USE_CHAR_CLASSIFIERS /* If char classifiers are needed */
66			# define USE_CHAR_CLASSIFIERS 1
67			#endif
68
69			#ifndef USE_ASCII_NAMES /* If extended escaped characters are needed */
70			# define USE_ASCII_NAMES 1
71			#endif
72
73			#ifndef USE_PORTS /* Enable ports */
74			# define USE_PORTS 1
75			#endif
76
77			#ifndef USE_STRING_PORTS /* Enable string ports */
78			# define USE_STRING_PORTS USE_PORTS
79			#endif
80
81			#ifndef USE_TRACING
82			# define USE_TRACING 1
83			#endif
84
85			#ifndef USE_PLIST
86			# define USE_PLIST 0
87			#endif
88	root	1.1
89			/* To force system errors through user-defined error handling (see error-hook) */
90	root	1.2	#ifndef USE_ERROR_HOOK
91			# define USE_ERROR_HOOK 1
92			#endif
93
94			#ifndef USE_COLON_HOOK /* Enable qualified qualifier */
95			# define USE_COLON_HOOK 1
96			#endif
97
98			#ifndef USE_ERROR_CHECKING
99			# define USE_ERROR_CHECKING 1
100			#endif
101
102			#ifndef USE_PRINTF
103			# define USE_PRINTF 1
104			#endif
105
106	root	1.6	#ifndef USE_IGNORECASE
107			# define USE_IGNORECASE 1
108	root	1.2	#endif
109
110	root	1.6	#ifndef SHOW_ERROR_LINE /* Show error line in file */
111			# define SHOW_ERROR_LINE 1
112	root	1.2	#endif
113
114	root	1.6	#if !USE_REAL
115			# undef USE_MATH
116			# define USE_MATH 0
117	root	1.2	#endif
118
119			#if USE_MULTIPLICITY
120			# define SCHEME_V sc
121			# define SCHEME_P scheme *SCHEME_V
122			# define SCHEME_P_ SCHEME_P,
123			# define SCHEME_A SCHEME_V
124			# define SCHEME_A_ SCHEME_A,
125			#else
126			# define SCHEME_V (&sc)
127			# define SCHEME_P
128			# define SCHEME_P_
129			# define SCHEME_A
130			# define SCHEME_A_
131			#endif
132	root	1.1
133	root	1.5	typedef struct scheme scheme;
134			typedef struct cell *pointer;
135	root	1.1
136	root	1.5	typedef long IVALUE; /* this is not used consistently yet */
137			#if USE_REAL
138			typedef double RVALUE;
139	root	1.2	#else
140	root	1.5	typedef long RVALUE;
141	root	1.2	#endif
142	root	1.1
143			/* Used for documentation purposes, to signal functions in 'interface' */
144	root	1.2	#define INTERFACE static
145	root	1.1
146	root	1.5	SCHEME_EXPORT scheme *scheme_init_new ();
147			SCHEME_EXPORT int scheme_init (SCHEME_P);
148			SCHEME_EXPORT void scheme_deinit (SCHEME_P);
149			void scheme_set_input_port_file (SCHEME_P_ int fin);
150			void scheme_set_input_port_string (SCHEME_P_ char start, char past_the_end);
151			SCHEME_EXPORT void scheme_set_output_port_file (SCHEME_P_ int fin);
152			void scheme_set_output_port_string (SCHEME_P_ char start, char past_the_end);
153			SCHEME_EXPORT void scheme_load_file (SCHEME_P_ int fin);
154			SCHEME_EXPORT void scheme_load_named_file (SCHEME_P_ int fin, const char *filename);
155			SCHEME_EXPORT void scheme_load_string (SCHEME_P_ const char *cmd);
156			SCHEME_EXPORT pointer scheme_apply0 (SCHEME_P_ const char *procname);
157			SCHEME_EXPORT pointer scheme_call (SCHEME_P_ pointer func, pointer args);
158			SCHEME_EXPORT pointer scheme_eval (SCHEME_P_ pointer obj);
159			void scheme_set_external_data (SCHEME_P_ void *p);
160			SCHEME_EXPORT void scheme_define (SCHEME_P_ pointer env, pointer symbol, pointer value);
161
162			typedef pointer (*foreign_func) (SCHEME_P_ pointer);
163
164			pointer xcons (SCHEME_P_ pointer a, pointer b, int immutable);
165	root	1.7	INTERFACE pointer mk_integer (SCHEME_P_ IVALUE n);
166			INTERFACE pointer mk_real (SCHEME_P_ RVALUE n);
167	root	1.5	INTERFACE pointer mk_symbol (SCHEME_P_ const char *name);
168			INTERFACE pointer gensym (SCHEME_P);
169			INTERFACE pointer mk_string (SCHEME_P_ const char *str);
170			INTERFACE pointer mk_counted_string (SCHEME_P_ const char *str, uint32_t len);
171			INTERFACE pointer mk_empty_string (SCHEME_P_ uint32_t len, char fill);
172			INTERFACE pointer mk_character (SCHEME_P_ int c);
173			INTERFACE pointer mk_foreign_func (SCHEME_P_ foreign_func f);
174			INTERFACE void putstr (SCHEME_P_ const char *s);
175			INTERFACE int list_length (SCHEME_P_ pointer a);
176			INTERFACE int eqv (pointer a, pointer b);
177	root	1.1
178	root	1.2	#if !STANDALONE
179	root	1.5	typedef struct scheme_registerable
180			{
181			foreign_func f;
182			const char *name;
183			} scheme_registerable;
184	root	1.1
185	root	1.5	void scheme_register_foreign_func_list (SCHEME_P_ scheme_registerable * list, int n);
186	root	1.2	#endif /* !STANDALONE */
187	root	1.1
188	root	1.2	#ifdef __cplusplus
189	root	1.1	}
190	root	1.2	#endif
191	root	1.1
192			#endif
193
194			/*
195			Local variables:
196			c-file-style: "k&r"
197			End:
198			*/