* socket.c (scm_inet_aton, scm_inet_pton): Convert SCM strings to
[bpt/guile.git] / libguile / validate.h
CommitLineData
b29058ff
DH
1/* classes: h_files */
2
3#ifndef SCM_VALIDATE_H
4#define SCM_VALIDATE_H
5
6182ceac 6/* Copyright (C) 1999,2000,2001, 2002 Free Software Foundation, Inc.
e94e3f21 7 *
73be1d9e
MV
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
e94e3f21 12 *
73be1d9e 13 * This library is distributed in the hope that it will be useful,
5bff3127 14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
73be1d9e
MV
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
e94e3f21 17 *
73be1d9e
MV
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 */
5bff3127
GB
22
23/* Written by Greg J. Badros <gjb@cs.washington.edu>, Dec-1999 */
1bbd0b84 24
b29058ff 25\f
1bbd0b84 26
39bcc76e 27#define SCM_SYSERROR do { scm_syserror (FUNC_NAME); } while (0)
1bbd0b84 28
39bcc76e 29#define SCM_MEMORY_ERROR do { scm_memory_error (FUNC_NAME); } while (0)
1bbd0b84 30
39bcc76e
MD
31#define SCM_SYSERROR_MSG(str, args, val) \
32 do { scm_syserror_msg (FUNC_NAME, (str), (args), (val)); } while (0)
1bbd0b84 33
39bcc76e
MD
34#define SCM_MISC_ERROR(str, args) \
35 do { scm_misc_error (FUNC_NAME, str, args); } while (0)
1bbd0b84 36
398d8ee1 37#define SCM_WRONG_NUM_ARGS() \
68baa7e7 38 do { scm_error_num_args_subr (FUNC_NAME); } while (0)
398d8ee1 39
39bcc76e
MD
40#define SCM_WRONG_TYPE_ARG(pos, obj) \
41 do { scm_wrong_type_arg (FUNC_NAME, pos, obj); } while (0)
1bbd0b84 42
b9bd8526 43#define SCM_NUM2SIZE(pos, arg) (scm_to_size_t (arg))
1be6b49c
ML
44
45#define SCM_NUM2SIZE_DEF(pos, arg, def) \
b9bd8526 46 (SCM_UNBNDP (arg) ? def : scm_to_size_t (arg))
1be6b49c 47
b9bd8526 48#define SCM_NUM2PTRDIFF(pos, arg) (scm_to_ssize_t (arg))
1be6b49c
ML
49
50#define SCM_NUM2PTRDIFF_DEF(pos, arg, def) \
b9bd8526 51 (SCM_UNBNDP (arg) ? def : scm_to_ssize_t (arg))
1be6b49c 52
b9bd8526 53#define SCM_NUM2SHORT(pos, arg) (scm_to_short (arg))
1be6b49c
ML
54
55#define SCM_NUM2SHORT_DEF(pos, arg, def) \
b9bd8526 56 (SCM_UNBNDP (arg) ? def : scm_to_short (arg))
1be6b49c 57
b9bd8526 58#define SCM_NUM2USHORT(pos, arg) (scm_to_ushort (arg))
1be6b49c
ML
59
60#define SCM_NUM2USHORT_DEF(pos, arg, def) \
b9bd8526 61 (SCM_UNBNDP (arg) ? def : scm_to_ushort (arg))
1be6b49c 62
b9bd8526 63#define SCM_NUM2INT(pos, arg) (scm_to_int (arg))
1be6b49c
ML
64
65#define SCM_NUM2INT_DEF(pos, arg, def) \
b9bd8526 66 (SCM_UNBNDP (arg) ? def : scm_to_int (arg))
1be6b49c 67
b9bd8526 68#define SCM_NUM2UINT(pos, arg) (scm_to_uint (arg))
1be6b49c
ML
69
70#define SCM_NUM2UINT_DEF(pos, arg, def) \
b9bd8526 71 (SCM_UNBNDP (arg) ? def : scm_to_uint (arg))
1be6b49c 72
b9bd8526 73#define SCM_NUM2ULONG(pos, arg) (scm_to_ulong (arg))
1bbd0b84 74
1be6b49c 75#define SCM_NUM2ULONG_DEF(pos, arg, def) \
b9bd8526 76 (SCM_UNBNDP (arg) ? def : scm_to_ulong (arg))
1be6b49c 77
b9bd8526 78#define SCM_NUM2LONG(pos, arg) (scm_to_long (arg))
1bbd0b84 79
39bcc76e 80#define SCM_NUM2LONG_DEF(pos, arg, def) \
b9bd8526 81 (SCM_UNBNDP (arg) ? def : scm_to_long (arg))
c1bfcf60 82
b9bd8526 83#define SCM_NUM2LONG_LONG(pos, arg) (scm_to_long_long (arg))
1bbd0b84 84
1be6b49c 85#define SCM_NUM2LONG_LONG_DEF(pos, arg, def) \
b9bd8526 86 (SCM_UNBNDP (arg) ? def : scm_to_long_long (arg))
1be6b49c 87
b9bd8526 88#define SCM_NUM2ULONG_LONG(pos, arg) (scm_to_ulong_long (arg))
1be6b49c
ML
89
90#define SCM_NUM2ULONG_LONG_DEF(pos, arg, def) \
b9bd8526 91 (SCM_UNBNDP (arg) ? def : scm_to_ulong_long (arg))
1be6b49c 92
581ded70
MD
93#define SCM_NUM2FLOAT(pos, arg) \
94 (scm_num2float (arg, pos, FUNC_NAME))
95
96#define SCM_NUM2DOUBLE(pos, arg) \
97 (scm_num2double (arg, pos, FUNC_NAME))
98
39bcc76e 99#define SCM_OUT_OF_RANGE(pos, arg) \
93ccaef0 100 do { scm_out_of_range_pos (FUNC_NAME, arg, scm_from_int (pos)); } while (0)
1bbd0b84 101
39bcc76e 102#define SCM_ASSERT_RANGE(pos, arg, f) \
93ccaef0 103 do { if (!(f)) scm_out_of_range_pos (FUNC_NAME, arg, scm_from_int (pos)); } while (0)
1bbd0b84 104
39bcc76e
MD
105#define SCM_MUST_MALLOC_TYPE(type) \
106 ((type *) scm_must_malloc (sizeof (type), FUNC_NAME))
1bbd0b84 107
39bcc76e
MD
108#define SCM_MUST_MALLOC_TYPE_NUM(type, num) \
109 ((type *) scm_must_malloc (sizeof (type) * (num), FUNC_NAME))
1bbd0b84 110
39bcc76e 111#define SCM_MUST_MALLOC(size) (scm_must_malloc ((size), FUNC_NAME))
1bbd0b84 112
39bcc76e
MD
113#define SCM_MAKE_VALIDATE(pos, var, pred) \
114 do { \
115 SCM_ASSERT_TYPE (SCM_ ## pred (var), var, pos, FUNC_NAME, #pred); \
116 } while (0)
6b5a304f 117
6182ceac
MV
118#define SCM_MAKE_VALIDATE_MSG(pos, var, pred, msg) \
119 do { \
120 SCM_ASSERT_TYPE (SCM_ ## pred (var), var, pos, FUNC_NAME, msg); \
121 } while (0)
122
6e8d25a6
GB
123\f
124
af45e3b0
DH
125#define SCM_VALIDATE_REST_ARGUMENT(x) \
126 do { \
127 if (SCM_DEBUG_REST_ARGUMENT) { \
128 if (scm_ilength (x) < 0) { \
129 SCM_MISC_ERROR ("Rest arguments do not form a proper list.", SCM_EOL); \
130 } \
131 } \
132 } while (0)
133
6182ceac 134#define SCM_VALIDATE_NIM(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, NIMP, "non-immediate")
6e8d25a6 135
7888309b
MV
136#define SCM_VALIDATE_BOOL(pos, flag) \
137 do { \
138 SCM_ASSERT_TYPE (scm_is_bool (flag), flag, pos, FUNC_NAME, "boolean"); \
139 } while (0)
1bbd0b84 140
39bcc76e
MD
141#define SCM_VALIDATE_BOOL_COPY(pos, flag, cvar) \
142 do { \
7888309b 143 SCM_ASSERT (scm_is_bool (flag), flag, pos, FUNC_NAME); \
bc36d050 144 cvar = scm_to_bool (flag); \
39bcc76e 145 } while (0)
1bbd0b84 146
6182ceac 147#define SCM_VALIDATE_CHAR(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, CHARP, "character")
1bbd0b84 148
39bcc76e
MD
149#define SCM_VALIDATE_CHAR_COPY(pos, scm, cvar) \
150 do { \
151 SCM_ASSERT (SCM_CHARP (scm), scm, pos, FUNC_NAME); \
152 cvar = SCM_CHAR (scm); \
153 } while (0)
1bbd0b84 154
6182ceac 155#define SCM_VALIDATE_STRING(pos, str) SCM_MAKE_VALIDATE_MSG (pos, str, STRINGP, "string")
1bbd0b84 156
39bcc76e
MD
157#define SCM_VALIDATE_STRING_COPY(pos, str, cvar) \
158 do { \
159 SCM_ASSERT (SCM_STRINGP (str), str, pos, FUNC_NAME); \
86c991c2 160 cvar = SCM_STRING_CHARS(str); \
39bcc76e 161 } while (0)
1bbd0b84 162
60d02d09
GH
163/* validate a string and optional start/end arguments which default to
164 0/string-len. this is unrelated to the old shared substring
165 support, so please do not deprecate it :) */
166#define SCM_VALIDATE_SUBSTRING_SPEC_COPY(pos_str, str, c_str, \
167 pos_start, start, c_start,\
168 pos_end, end, c_end) \
169 do {\
170 SCM_VALIDATE_STRING_COPY (pos_str, str, c_str);\
8805b77d
MV
171 c_start = SCM_UNBNDP(start)? 0 : scm_to_size_t (start);\
172 c_end = SCM_UNBNDP(end)? SCM_STRING_LENGTH(str) : scm_to_size_t (end);\
60d02d09 173 SCM_ASSERT_RANGE (pos_start, start,\
36284627
DH
174 0 <= c_start \
175 && (size_t) c_start <= SCM_STRING_LENGTH (str));\
60d02d09 176 SCM_ASSERT_RANGE (pos_end, end,\
36284627
DH
177 c_start <= c_end \
178 && (size_t) c_end <= SCM_STRING_LENGTH (str));\
60d02d09
GH
179 } while (0)
180
6182ceac 181#define SCM_VALIDATE_REAL(pos, z) SCM_MAKE_VALIDATE_MSG (pos, z, REALP, "real")
1bbd0b84 182
6182ceac 183#define SCM_VALIDATE_NUMBER(pos, z) SCM_MAKE_VALIDATE_MSG (pos, z, NUMBERP, "number")
e8a46ba8 184
d098d810
TTN
185#define SCM_VALIDATE_USHORT_COPY(pos, k, cvar) \
186 do { \
187 cvar = SCM_NUM2USHORT (pos, k); \
188 } while (0)
189
190#define SCM_VALIDATE_SHORT_COPY(pos, k, cvar) \
191 do { \
192 cvar = SCM_NUM2SHORT (pos, k); \
193 } while (0)
194
195#define SCM_VALIDATE_UINT_COPY(pos, k, cvar) \
196 do { \
197 cvar = SCM_NUM2UINT (pos, k); \
198 } while (0)
199
200#define SCM_VALIDATE_INT_COPY(pos, k, cvar) \
201 do { \
202 cvar = SCM_NUM2INT (pos, k); \
203 } while (0)
204
39bcc76e
MD
205#define SCM_VALIDATE_ULONG_COPY(pos, k, cvar) \
206 do { \
207 cvar = SCM_NUM2ULONG (pos, k); \
208 } while (0)
2cd04b42 209
39bcc76e
MD
210#define SCM_VALIDATE_LONG_COPY(pos, k, cvar) \
211 do { \
e4b265d8 212 cvar = SCM_NUM2LONG (pos, k); \
39bcc76e 213 } while (0)
2cd04b42 214
581ded70
MD
215#define SCM_VALIDATE_FLOAT_COPY(pos, k, cvar) \
216 do { \
217 cvar = SCM_NUM2FLOAT (pos, k); \
218 } while (0)
219
220#define SCM_VALIDATE_DOUBLE_COPY(pos, k, cvar) \
221 do { \
222 cvar = SCM_NUM2DOUBLE (pos, k); \
223 } while (0)
224
68665a97
MD
225#define SCM_VALIDATE_DOUBLE_DEF_COPY(pos, k, default, cvar) \
226 do { \
227 if (SCM_UNBNDP (k)) \
228 { \
229 k = scm_make_real (default); \
230 cvar = default; \
231 } \
232 else \
233 { \
234 cvar = SCM_NUM2DOUBLE (pos, k); \
235 } \
236 } while (0)
237
6182ceac 238#define SCM_VALIDATE_NULL(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, NULLP, "null")
1bbd0b84 239
6182ceac 240#define SCM_VALIDATE_NULL_OR_NIL(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, NULL_OR_NIL_P, "null")
c96d76b8 241
6182ceac 242#define SCM_VALIDATE_CONS(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, CONSP, "pair")
1bbd0b84 243
39bcc76e
MD
244#define SCM_VALIDATE_LIST(pos, lst) \
245 do { \
246 SCM_ASSERT (scm_ilength (lst) >= 0, lst, pos, FUNC_NAME); \
247 } while (0)
1bbd0b84 248
39bcc76e
MD
249#define SCM_VALIDATE_NONEMPTYLIST(pos, lst) \
250 do { \
251 SCM_ASSERT (scm_ilength (lst) > 0, lst, pos, FUNC_NAME); \
252 } while (0)
1bbd0b84 253
39bcc76e
MD
254#define SCM_VALIDATE_LIST_COPYLEN(pos, lst, cvar) \
255 do { \
256 cvar = scm_ilength (lst); \
257 SCM_ASSERT (cvar >= 0, lst, pos, FUNC_NAME); \
258 } while (0)
c1bfcf60 259
39bcc76e
MD
260#define SCM_VALIDATE_NONEMPTYLIST_COPYLEN(pos, lst, cvar) \
261 do { \
262 cvar = scm_ilength (lst); \
263 SCM_ASSERT (cvar >= 1, lst, pos, FUNC_NAME); \
264 } while (0)
1bbd0b84 265
39bcc76e
MD
266#define SCM_VALIDATE_ALISTCELL(pos, alist) \
267 do { \
268 SCM_ASSERT (SCM_CONSP (alist) && SCM_CONSP (SCM_CAR (alist)), \
269 alist, pos, FUNC_NAME); \
270 } while (0)
1bbd0b84 271
39bcc76e 272#define SCM_VALIDATE_ALISTCELL_COPYSCM(pos, alist, cvar) \
1bbd0b84 273 do { \
39bcc76e
MD
274 SCM_ASSERT (SCM_CONSP (alist), alist, pos, FUNC_NAME); \
275 cvar = SCM_CAR (alist); \
276 SCM_ASSERT (SCM_CONSP (cvar), alist, pos, FUNC_NAME); \
30939477 277 } while (0)
1bbd0b84 278
39bcc76e 279#define SCM_VALIDATE_OPORT_VALUE(pos, port) \
1bbd0b84 280 do { \
39bcc76e
MD
281 SCM_ASSERT (scm_valid_oport_value_p (port), port, pos, FUNC_NAME); \
282 } while (0)
283
6182ceac 284#define SCM_VALIDATE_PRINTSTATE(pos, a) SCM_MAKE_VALIDATE_MSG(pos, a, PRINT_STATE_P, "print-state")
1bbd0b84 285
39bcc76e
MD
286#define SCM_VALIDATE_SMOB(pos, obj, type) \
287 do { \
e841c3e0 288 SCM_ASSERT (SCM_TYP16_PREDICATE (scm_tc16_ ## type, obj), \
39bcc76e
MD
289 obj, pos, FUNC_NAME); \
290 } while (0)
1bbd0b84 291
39bcc76e
MD
292#define SCM_VALIDATE_THUNK(pos, thunk) \
293 do { \
7888309b 294 SCM_ASSERT (scm_is_true (scm_thunk_p (thunk)), thunk, pos, FUNC_NAME); \
39bcc76e 295 } while (0)
1bbd0b84 296
6182ceac 297#define SCM_VALIDATE_SYMBOL(pos, sym) SCM_MAKE_VALIDATE_MSG (pos, sym, SYMBOLP, "symbol")
0c95b57d 298
6182ceac 299#define SCM_VALIDATE_VARIABLE(pos, var) SCM_MAKE_VALIDATE_MSG (pos, var, VARIABLEP, "variable")
1bbd0b84 300
6182ceac 301#define SCM_VALIDATE_MEMOIZED(pos, obj) SCM_MAKE_VALIDATE_MSG (pos, obj, MEMOIZEDP, "memoized code")
1bbd0b84 302
6182ceac 303#define SCM_VALIDATE_CLOSURE(pos, obj) SCM_MAKE_VALIDATE_MSG (pos, obj, CLOSUREP, "closure")
1bbd0b84 304
39bcc76e
MD
305#define SCM_VALIDATE_PROC(pos, proc) \
306 do { \
bc36d050 307 SCM_ASSERT (scm_is_true (scm_procedure_p (proc)), proc, pos, FUNC_NAME); \
39bcc76e 308 } while (0)
1bbd0b84 309
39bcc76e
MD
310#define SCM_VALIDATE_NULLORCONS(pos, env) \
311 do { \
312 SCM_ASSERT (SCM_NULLP (env) || SCM_CONSP (env), env, pos, FUNC_NAME); \
313 } while (0)
1bbd0b84 314
6182ceac 315#define SCM_VALIDATE_HOOK(pos, a) SCM_MAKE_VALIDATE_MSG (pos, a, HOOKP, "hook")
1bbd0b84 316
6182ceac 317#define SCM_VALIDATE_RGXP(pos, a) SCM_MAKE_VALIDATE_MSG (pos, a, RGXP, "regexp")
1bbd0b84 318
6182ceac 319#define SCM_VALIDATE_DIR(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, DIRP, "directory port")
1bbd0b84 320
6182ceac 321#define SCM_VALIDATE_PORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, PORTP, "port")
1bbd0b84 322
39bcc76e 323#define SCM_VALIDATE_INPUT_PORT(pos, port) \
6182ceac 324 SCM_MAKE_VALIDATE_MSG (pos, port, INPUT_PORT_P, "input port")
1bbd0b84 325
39bcc76e 326#define SCM_VALIDATE_OUTPUT_PORT(pos, port) \
6182ceac 327 SCM_MAKE_VALIDATE_MSG (pos, port, OUTPUT_PORT_P, "output port")
1bbd0b84 328
6182ceac 329#define SCM_VALIDATE_FPORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, FPORTP, "file port")
1bbd0b84 330
6182ceac 331#define SCM_VALIDATE_OPFPORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, OPFPORTP, "open file port")
1bbd0b84 332
39bcc76e 333#define SCM_VALIDATE_OPINPORT(pos, port) \
6182ceac 334 SCM_MAKE_VALIDATE_MSG (pos, port, OPINPORTP, "open input port")
1bbd0b84 335
34d19ef6 336#define SCM_VALIDATE_OPENPORT(pos, port) \
39bcc76e
MD
337 do { \
338 SCM_ASSERT (SCM_PORTP (port) && SCM_OPENP (port), \
339 port, pos, FUNC_NAME); \
340 } while (0)
1bbd0b84 341
6182ceac 342#define SCM_VALIDATE_OPPORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, OPPORTP, "open port")
1bbd0b84 343
39bcc76e 344#define SCM_VALIDATE_OPOUTPORT(pos, port) \
6182ceac 345 SCM_MAKE_VALIDATE_MSG (pos, port, OPOUTPORTP, "open output port")
1bbd0b84 346
e87a03fc 347#define SCM_VALIDATE_OPOUTSTRPORT(pos, port) \
6182ceac 348 SCM_MAKE_VALIDATE_MSG (pos, port, OPOUTSTRPORTP, "open output string port")
e87a03fc 349
6182ceac 350#define SCM_VALIDATE_FLUID(pos, fluid) SCM_MAKE_VALIDATE_MSG (pos, fluid, FLUIDP, "fluid")
1bbd0b84 351
6182ceac 352#define SCM_VALIDATE_KEYWORD(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, KEYWORDP, "keyword")
1bbd0b84 353
6182ceac 354#define SCM_VALIDATE_STACK(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, STACKP, "stack")
1bbd0b84 355
6182ceac 356#define SCM_VALIDATE_FRAME(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, FRAMEP, "frame")
1bbd0b84 357
6182ceac 358#define SCM_VALIDATE_RSTATE(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, RSTATEP, "random-generator-state")
1bbd0b84 359
34d19ef6 360#define SCM_VALIDATE_ARRAY(pos, v) \
39bcc76e 361 do { \
b29058ff 362 SCM_ASSERT (!SCM_IMP (v) \
7888309b 363 && scm_is_true (scm_array_p (v, SCM_UNDEFINED)), \
39bcc76e
MD
364 v, pos, FUNC_NAME); \
365 } while (0)
1bbd0b84 366
6182ceac 367#define SCM_VALIDATE_VECTOR(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, VECTORP, "vector")
1bbd0b84 368
39bcc76e
MD
369#define SCM_VALIDATE_VECTOR_OR_DVECTOR(pos, v) \
370 do { \
371 SCM_ASSERT ((SCM_VECTORP (v) \
b29058ff 372 || (!SCM_IMP (v) && SCM_TYP7 (v) == scm_tc7_dvect)), \
39bcc76e
MD
373 v, pos, FUNC_NAME); \
374 } while (0)
368cf54d 375
6182ceac 376#define SCM_VALIDATE_STRUCT(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, STRUCTP, "struct")
1bbd0b84 377
39bcc76e
MD
378#define SCM_VALIDATE_VTABLE(pos, v) \
379 do { \
7888309b 380 SCM_ASSERT (!SCM_IMP (v) && scm_is_true (scm_struct_vtable_p (v)), \
39bcc76e
MD
381 v, pos, FUNC_NAME); \
382 } while (0)
1bbd0b84 383
39bcc76e
MD
384#define SCM_VALIDATE_VECTOR_LEN(pos, v, len) \
385 do { \
9fd38a3d 386 SCM_ASSERT (SCM_VECTORP (v) && len == SCM_VECTOR_LENGTH (v), v, pos, FUNC_NAME); \
39bcc76e 387 } while (0)
1bbd0b84 388
b29058ff 389#endif /* SCM_VALIDATE_H */
89e00824
ML
390
391/*
392 Local Variables:
393 c-file-style: "gnu"
394 End:
395*/