libguile/validate.h

   1 /* classes: h_files */
   2
   3 #ifndef SCM_VALIDATE_H
   4 #define SCM_VALIDATE_H
   5
   6 /* Copyright (C) 1999,2000,2001, 2002 Free Software Foundation, Inc.
   7  *
   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.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  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  */
  22
  23 /* Written by Greg J. Badros <gjb@cs.washington.edu>, Dec-1999 */
  24
  25 \f
  26
  27 #define SCM_SYSERROR do { scm_syserror (FUNC_NAME); } while (0)
  28
  29 #define SCM_MEMORY_ERROR do { scm_memory_error (FUNC_NAME); } while (0)
  30
  31 #define SCM_SYSERROR_MSG(str, args, val) \
  32   do { scm_syserror_msg (FUNC_NAME, (str), (args), (val)); } while (0)
  33
  34 #define SCM_MISC_ERROR(str, args) \
  35   do { scm_misc_error (FUNC_NAME, str, args); } while (0)
  36
  37 #define SCM_WRONG_NUM_ARGS() \
  38   do { scm_error_num_args_subr (FUNC_NAME); } while (0)
  39
  40 #define SCM_WRONG_TYPE_ARG(pos, obj) \
  41   do { scm_wrong_type_arg (FUNC_NAME, pos, obj); } while (0)
  42
  43 #define SCM_NUM2SIZE(pos, arg) (scm_to_size_t (arg))
  44
  45 #define SCM_NUM2SIZE_DEF(pos, arg, def) \
  46   (SCM_UNBNDP (arg) ? def : scm_to_size_t (arg))
  47
  48 #define SCM_NUM2PTRDIFF(pos, arg) (scm_to_ssize_t (arg))
  49
  50 #define SCM_NUM2PTRDIFF_DEF(pos, arg, def) \
  51   (SCM_UNBNDP (arg) ? def : scm_to_ssize_t (arg))
  52
  53 #define SCM_NUM2SHORT(pos, arg) (scm_to_short (arg))
  54
  55 #define SCM_NUM2SHORT_DEF(pos, arg, def) \
  56   (SCM_UNBNDP (arg) ? def : scm_to_short (arg))
  57
  58 #define SCM_NUM2USHORT(pos, arg) (scm_to_ushort (arg))
  59
  60 #define SCM_NUM2USHORT_DEF(pos, arg, def) \
  61   (SCM_UNBNDP (arg) ? def : scm_to_ushort (arg))
  62
  63 #define SCM_NUM2INT(pos, arg) (scm_to_int (arg))
  64
  65 #define SCM_NUM2INT_DEF(pos, arg, def) \
  66   (SCM_UNBNDP (arg) ? def : scm_to_int (arg))
  67
  68 #define SCM_NUM2UINT(pos, arg) (scm_to_uint (arg))
  69
  70 #define SCM_NUM2UINT_DEF(pos, arg, def) \
  71   (SCM_UNBNDP (arg) ? def : scm_to_uint (arg))
  72
  73 #define SCM_NUM2ULONG(pos, arg) (scm_to_ulong (arg))
  74
  75 #define SCM_NUM2ULONG_DEF(pos, arg, def) \
  76   (SCM_UNBNDP (arg) ? def : scm_to_ulong (arg))
  77
  78 #define SCM_NUM2LONG(pos, arg) (scm_to_long (arg))
  79
  80 #define SCM_NUM2LONG_DEF(pos, arg, def) \
  81   (SCM_UNBNDP (arg) ? def : scm_to_long (arg))
  82
  83 #define SCM_NUM2LONG_LONG(pos, arg) (scm_to_long_long (arg))
  84
  85 #define SCM_NUM2LONG_LONG_DEF(pos, arg, def) \
  86   (SCM_UNBNDP (arg) ? def : scm_to_long_long (arg))
  87
  88 #define SCM_NUM2ULONG_LONG(pos, arg) (scm_to_ulong_long (arg))
  89
  90 #define SCM_NUM2ULONG_LONG_DEF(pos, arg, def) \
  91   (SCM_UNBNDP (arg) ? def : scm_to_ulong_long (arg))
  92
  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
  99 #define SCM_OUT_OF_RANGE(pos, arg) \
 100   do { scm_out_of_range_pos (FUNC_NAME, arg, scm_from_int (pos)); } while (0)
 101
 102 #define SCM_ASSERT_RANGE(pos, arg, f) \
 103   do { if (!(f)) scm_out_of_range_pos (FUNC_NAME, arg, scm_from_int (pos)); } while (0)
 104
 105 #define SCM_MUST_MALLOC_TYPE(type) \
 106   ((type *) scm_must_malloc (sizeof (type), FUNC_NAME))
 107
 108 #define SCM_MUST_MALLOC_TYPE_NUM(type, num) \
 109   ((type *) scm_must_malloc (sizeof (type) * (num), FUNC_NAME))
 110
 111 #define SCM_MUST_MALLOC(size) (scm_must_malloc ((size), FUNC_NAME))
 112
 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)
 117
 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
 123 \f
 124
 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
 134 #define SCM_VALIDATE_NIM(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, NIMP, "non-immediate")
 135
 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)
 140
 141 #define SCM_VALIDATE_BOOL_COPY(pos, flag, cvar) \
 142   do { \
 143     SCM_ASSERT (scm_is_bool (flag), flag, pos, FUNC_NAME); \
 144     cvar = scm_to_bool (flag); \
 145   } while (0)
 146
 147 #define SCM_VALIDATE_CHAR(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, CHARP, "character")
 148
 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)
 154
 155 #define SCM_VALIDATE_STRING(pos, str) SCM_MAKE_VALIDATE_MSG (pos, str, I_STRINGP, "string")
 156
 157 #define SCM_VALIDATE_REAL(pos, z) SCM_MAKE_VALIDATE_MSG (pos, z, REALP, "real")
 158
 159 #define SCM_VALIDATE_NUMBER(pos, z) SCM_MAKE_VALIDATE_MSG (pos, z, NUMBERP, "number")
 160
 161 #define SCM_VALIDATE_USHORT_COPY(pos, k, cvar) \
 162   do { \
 163     cvar = SCM_NUM2USHORT (pos, k); \
 164   } while (0)
 165
 166 #define SCM_VALIDATE_SHORT_COPY(pos, k, cvar) \
 167   do { \
 168     cvar = SCM_NUM2SHORT (pos, k); \
 169   } while (0)
 170
 171 #define SCM_VALIDATE_UINT_COPY(pos, k, cvar) \
 172   do { \
 173     cvar = SCM_NUM2UINT (pos, k); \
 174   } while (0)
 175
 176 #define SCM_VALIDATE_INT_COPY(pos, k, cvar) \
 177   do { \
 178     cvar = SCM_NUM2INT (pos, k); \
 179   } while (0)
 180
 181 #define SCM_VALIDATE_ULONG_COPY(pos, k, cvar) \
 182   do { \
 183     cvar = SCM_NUM2ULONG (pos, k); \
 184   } while (0)
 185
 186 #define SCM_VALIDATE_LONG_COPY(pos, k, cvar) \
 187   do { \
 188     cvar = SCM_NUM2LONG (pos, k); \
 189   } while (0)
 190
 191 #define SCM_VALIDATE_FLOAT_COPY(pos, k, cvar) \
 192   do { \
 193     cvar = SCM_NUM2FLOAT (pos, k); \
 194   } while (0)
 195
 196 #define SCM_VALIDATE_DOUBLE_COPY(pos, k, cvar) \
 197   do { \
 198     cvar = SCM_NUM2DOUBLE (pos, k); \
 199   } while (0)
 200
 201 #define SCM_VALIDATE_DOUBLE_DEF_COPY(pos, k, default, cvar) \
 202   do { \
 203     if (SCM_UNBNDP (k)) \
 204       { \
 205         k = scm_make_real (default); \
 206         cvar = default; \
 207       } \
 208     else \
 209       { \
 210         cvar = SCM_NUM2DOUBLE (pos, k); \
 211       } \
 212   } while (0)
 213
 214 #define SCM_VALIDATE_NULL(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, NULLP, "null")
 215
 216 #define SCM_VALIDATE_NULL_OR_NIL(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, NULL_OR_NIL_P, "null")
 217
 218 #define SCM_VALIDATE_CONS(pos, scm) SCM_MAKE_VALIDATE_MSG (pos, scm, CONSP, "pair")
 219
 220 #define SCM_VALIDATE_LIST(pos, lst) \
 221   do { \
 222     SCM_ASSERT (scm_ilength (lst) >= 0, lst, pos, FUNC_NAME); \
 223   } while (0)
 224
 225 #define SCM_VALIDATE_NONEMPTYLIST(pos, lst) \
 226   do { \
 227     SCM_ASSERT (scm_ilength (lst) > 0, lst, pos, FUNC_NAME); \
 228   } while (0)
 229
 230 #define SCM_VALIDATE_LIST_COPYLEN(pos, lst, cvar) \
 231   do { \
 232     cvar = scm_ilength (lst); \
 233     SCM_ASSERT (cvar >= 0, lst, pos, FUNC_NAME); \
 234   } while (0)
 235
 236 #define SCM_VALIDATE_NONEMPTYLIST_COPYLEN(pos, lst, cvar) \
 237   do { \
 238     cvar = scm_ilength (lst); \
 239     SCM_ASSERT (cvar >= 1, lst, pos, FUNC_NAME); \
 240   } while (0)
 241
 242 #define SCM_VALIDATE_ALISTCELL(pos, alist) \
 243   do { \
 244     SCM_ASSERT (SCM_CONSP (alist) && SCM_CONSP (SCM_CAR (alist)), \
 245                 alist, pos, FUNC_NAME); \
 246   } while (0)
 247
 248 #define SCM_VALIDATE_ALISTCELL_COPYSCM(pos, alist, cvar) \
 249   do { \
 250     SCM_ASSERT (SCM_CONSP (alist), alist, pos, FUNC_NAME); \
 251     cvar = SCM_CAR (alist); \
 252     SCM_ASSERT (SCM_CONSP (cvar), alist, pos, FUNC_NAME); \
 253   } while (0)
 254
 255 #define SCM_VALIDATE_OPORT_VALUE(pos, port) \
 256   do { \
 257     SCM_ASSERT (scm_valid_oport_value_p (port), port, pos, FUNC_NAME); \
 258   } while (0)
 259
 260 #define SCM_VALIDATE_PRINTSTATE(pos, a) SCM_MAKE_VALIDATE_MSG(pos, a, PRINT_STATE_P, "print-state")
 261
 262 #define SCM_VALIDATE_SMOB(pos, obj, type) \
 263   do { \
 264     SCM_ASSERT (SCM_TYP16_PREDICATE (scm_tc16_ ## type, obj), \
 265                 obj, pos, FUNC_NAME); \
 266   } while (0)
 267
 268 #define SCM_VALIDATE_THUNK(pos, thunk) \
 269   do { \
 270     SCM_ASSERT (scm_is_true (scm_thunk_p (thunk)), thunk, pos, FUNC_NAME); \
 271   } while (0)
 272
 273 #define SCM_VALIDATE_SYMBOL(pos, sym) SCM_MAKE_VALIDATE_MSG (pos, sym, SYMBOLP, "symbol")
 274
 275 #define SCM_VALIDATE_VARIABLE(pos, var) SCM_MAKE_VALIDATE_MSG (pos, var, VARIABLEP, "variable")
 276
 277 #define SCM_VALIDATE_MEMOIZED(pos, obj) SCM_MAKE_VALIDATE_MSG (pos, obj, MEMOIZEDP, "memoized code")
 278
 279 #define SCM_VALIDATE_CLOSURE(pos, obj) SCM_MAKE_VALIDATE_MSG (pos, obj, CLOSUREP, "closure")
 280
 281 #define SCM_VALIDATE_PROC(pos, proc) \
 282   do { \
 283     SCM_ASSERT (scm_is_true (scm_procedure_p (proc)), proc, pos, FUNC_NAME); \
 284   } while (0)
 285
 286 #define SCM_VALIDATE_NULLORCONS(pos, env) \
 287   do { \
 288     SCM_ASSERT (SCM_NULLP (env) || SCM_CONSP (env), env, pos, FUNC_NAME); \
 289   } while (0)
 290
 291 #define SCM_VALIDATE_HOOK(pos, a) SCM_MAKE_VALIDATE_MSG (pos, a, HOOKP, "hook")
 292
 293 #define SCM_VALIDATE_RGXP(pos, a) SCM_MAKE_VALIDATE_MSG (pos, a, RGXP, "regexp")
 294
 295 #define SCM_VALIDATE_DIR(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, DIRP, "directory port")
 296
 297 #define SCM_VALIDATE_PORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, PORTP, "port")
 298
 299 #define SCM_VALIDATE_INPUT_PORT(pos, port) \
 300   SCM_MAKE_VALIDATE_MSG (pos, port, INPUT_PORT_P, "input port")
 301
 302 #define SCM_VALIDATE_OUTPUT_PORT(pos, port) \
 303   SCM_MAKE_VALIDATE_MSG (pos, port, OUTPUT_PORT_P, "output port")
 304
 305 #define SCM_VALIDATE_FPORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, FPORTP, "file port")
 306
 307 #define SCM_VALIDATE_OPFPORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, OPFPORTP, "open file port")
 308
 309 #define SCM_VALIDATE_OPINPORT(pos, port) \
 310   SCM_MAKE_VALIDATE_MSG (pos, port, OPINPORTP, "open input port")
 311
 312 #define SCM_VALIDATE_OPENPORT(pos, port) \
 313   do { \
 314     SCM_ASSERT (SCM_PORTP (port) && SCM_OPENP (port), \
 315                 port, pos, FUNC_NAME); \
 316   } while (0)
 317
 318 #define SCM_VALIDATE_OPPORT(pos, port) SCM_MAKE_VALIDATE_MSG (pos, port, OPPORTP, "open port")
 319
 320 #define SCM_VALIDATE_OPOUTPORT(pos, port) \
 321   SCM_MAKE_VALIDATE_MSG (pos, port, OPOUTPORTP, "open output port")
 322
 323 #define SCM_VALIDATE_OPOUTSTRPORT(pos, port) \
 324   SCM_MAKE_VALIDATE_MSG (pos, port, OPOUTSTRPORTP, "open output string port")
 325
 326 #define SCM_VALIDATE_FLUID(pos, fluid) SCM_MAKE_VALIDATE_MSG (pos, fluid, FLUIDP, "fluid")
 327
 328 #define SCM_VALIDATE_KEYWORD(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, KEYWORDP, "keyword")
 329
 330 #define SCM_VALIDATE_STACK(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, STACKP, "stack")
 331
 332 #define SCM_VALIDATE_FRAME(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, FRAMEP, "frame")
 333
 334 #define SCM_VALIDATE_RSTATE(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, RSTATEP, "random-generator-state")
 335
 336 #define SCM_VALIDATE_ARRAY(pos, v) \
 337   do { \
 338     SCM_ASSERT (!SCM_IMP (v) \
 339                 && scm_is_true (scm_array_p (v, SCM_UNDEFINED)), \
 340                 v, pos, FUNC_NAME); \
 341   } while (0)
 342
 343 #define SCM_VALIDATE_VECTOR(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, VECTORP, "vector")
 344
 345 #define SCM_VALIDATE_VECTOR_OR_DVECTOR(pos, v) \
 346   do { \
 347     SCM_ASSERT ((SCM_VECTORP (v) \
 348                 || (!SCM_IMP (v) && SCM_TYP7 (v) == scm_tc7_dvect)), \
 349                 v, pos, FUNC_NAME); \
 350   } while (0)
 351
 352 #define SCM_VALIDATE_STRUCT(pos, v) SCM_MAKE_VALIDATE_MSG (pos, v, STRUCTP, "struct")
 353
 354 #define SCM_VALIDATE_VTABLE(pos, v) \
 355   do { \
 356     SCM_ASSERT (!SCM_IMP (v) && scm_is_true (scm_struct_vtable_p (v)), \
 357                 v, pos, FUNC_NAME); \
 358   } while (0)
 359
 360 #define SCM_VALIDATE_VECTOR_LEN(pos, v, len) \
 361   do { \
 362     SCM_ASSERT (SCM_VECTORP (v) && len == SCM_VECTOR_LENGTH (v), v, pos, FUNC_NAME); \
 363   } while (0)
 364
 365
 366 #endif  /* SCM_VALIDATE_H */
 367
 368 /*
 369   Local Variables:
 370   c-file-style: "gnu"
 371   End:
 372 */