Fix: Don't cast SCM values to pointer. Use SCM2PTR instead.
[bpt/guile.git] / libguile / smob.h
index efba996..f7a2433 100644 (file)
@@ -2,7 +2,7 @@
 
 #ifndef SMOBH
 #define SMOBH
-/*     Copyright (C) 1995,1996 Free Software Foundation, Inc.
+/*     Copyright (C) 1995, 1996, 1998, 1999, 2000 Free Software Foundation, Inc.
  * 
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -16,7 +16,8 @@
  * 
  * You should have received a copy of the GNU General Public License
  * along with this software; see the file COPYING.  If not, write to
- * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+ * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
+ * Boston, MA 02111-1307 USA
  *
  * As a special exception, the Free Software Foundation gives permission
  * for additional uses of the text contained in its release of GUILE.
  *
  * If you write modifications of your own for GUILE, it is your choice
  * whether to permit this exception to apply to your modifications.
- * If you do not wish that, delete this exception notice.  
- */
+ * If you do not wish that, delete this exception notice.  */
 \f
 #include "libguile/__scm.h"
+#include "libguile/print.h"
 
 \f
+/* This is the internal representation of a smob type */
+
+typedef struct scm_smob_descriptor
+{
+  char *name;
+  scm_sizet size;
+  SCM (*mark) (SCM);
+  scm_sizet (*free) (SCM);
+  int (*print) (SCM exp, SCM port, scm_print_state *pstate);
+  SCM (*equalp) (SCM, SCM);
+} scm_smob_descriptor;
+
+/* scm_smobfuns is the argument type for the obsolete function scm_newsmob */
+
 typedef struct scm_smobfuns
 {
-  SCM (*mark) SCM_P ((SCM));
-  scm_sizet (*free) SCM_P ((SCM));
-  int (*print) SCM_P ((SCM exp, SCM port, scm_print_state *pstate));
-  SCM (*equalp) SCM_P ((SCM, SCM));
+  SCM (*mark) (SCM);
+  scm_sizet (*free) (SCM);
+  int (*print) (SCM exp, SCM port, scm_print_state *pstate);
+  SCM (*equalp) (SCM, SCM);
 } scm_smobfuns;
 
 \f
 
-#define SCM_SMOBNUM(x) (0x0ff & (SCM_CAR(x)>>8))
-#define SCM_PTOBNUM(x) (0x0ff & (SCM_CAR(x)>>8))
+#define SCM_NEWSMOB(z, tc, data) \
+do { \
+  SCM_NEWCELL (z); \
+  SCM_SETCDR (z, data); \
+  SCM_SETCAR (z, tc); \
+} while (0)
 
-extern scm_sizet scm_numsmob;
-extern scm_smobfuns *scm_smobs;
+#define SCM_RETURN_NEWSMOB(tc, data) \
+  do { SCM __SCM_smob_answer; \
+       SCM_NEWSMOB (__SCM_smob_answer, tc, data); \
+       return __SCM_smob_answer; \
+  } while (0)
 
-\f
+#define SCM_NEWSMOB2(z, tc, data1, data2) \
+do { \
+  SCM_NEWCELL2 (z); \
+  SCM_SET_CELL_WORD (z, 1, data1); \
+  SCM_SET_CELL_WORD (z, 2, data2); \
+  SCM_SETCAR (z, tc); \
+} while (0)
 
-/* Everyone who uses smobs needs to print.  */
-#include "libguile/ports.h"
-#include "libguile/genio.h"
+#define SCM_RETURN_NEWSMOB2(tc, data1, data2) \
+  do { SCM __SCM_smob_answer; \
+       SCM_NEWSMOB2 (__SCM_smob_answer, tc, data1, data2); \
+       return __SCM_smob_answer; \
+  } while (0)
 
-/* ... and they all need to GC.  */
-#include "libguile/markers.h"
+#define SCM_NEWSMOB3(z, tc, data1, data2, data3) \
+do { \
+  SCM_NEWCELL2 (z); \
+  SCM_SET_CELL_WORD (z, 1, data1); \
+  SCM_SET_CELL_WORD (z, 2, data2); \
+  SCM_SET_CELL_WORD (z, 3, data3); \
+  SCM_SETCAR (z, tc); \
+} while (0)
+
+#define SCM_RETURN_NEWSMOB3(tc, data1, data2, data3) \
+  do { SCM __SCM_smob_answer; \
+       SCM_NEWSMOB3 (__SCM_smob_answer, tc, data1, data2, data3); \
+       return __SCM_smob_answer; \
+  } while (0)
+
+
+#define SCM_SMOB_DATA(x) SCM_CDR (x)
+#define SCM_SET_SMOB_DATA(x, data) SCM_SETCDR (x, data)
+#define SCM_TC2SMOBNUM(x) (0x0ff & (SCM_UNPACK(x) >> 8))
+#define SCM_SMOBNUM(x) (SCM_TC2SMOBNUM (SCM_CAR (x)))
+/* SCM_SMOBNAME can be 0 if name is missing */
+#define SCM_SMOBNAME(smobnum) scm_smobs[smobnum].name
+#define SCM_SMOB_PREDICATE(tag, obj) \
+ (SCM_NIMP (obj) && SCM_TYP16 (obj) == (tag))
+
+extern int scm_numsmob;
+extern scm_smob_descriptor *scm_smobs;
 
 \f
-extern long scm_newsmob SCM_P ((scm_smobfuns *smob));
-extern void scm_smob_prehistory SCM_P ((void));
+
+extern SCM scm_mark0 (SCM ptr);
+extern SCM scm_markcdr (SCM ptr);
+extern scm_sizet scm_free0 (SCM ptr);
+extern scm_sizet scm_smob_free (SCM obj);
+extern int scm_smob_print (SCM exp, SCM port, scm_print_state *pstate);
+
+/* These next two functions are the supported way to create new SMOB types.
+   scm_make_smob_type is useful if there are no special smob functions
+     and the defaults work for mark,free,print,equal_p, or you want to use
+     scm_set_smob_{mark,free,print,equalp}, below.
+
+   scm_make_smob_type_mfpe is ideal if you need to set one or more of
+     the special smob functions-- use NULL for when the default function 
+     is fine 
+*/
+
+extern long scm_make_smob_type (char *name, scm_sizet size);
+
+extern long scm_make_smob_type_mfpe (char *name, scm_sizet size,
+                                    SCM (*mark) (SCM),
+                                    scm_sizet (*free) (SCM),
+                                    int (*print) (SCM, SCM, scm_print_state*),
+                                    SCM (*equalp) (SCM, SCM));
+
+extern void scm_set_smob_mark (long tc, SCM (*mark) (SCM));
+extern void scm_set_smob_free (long tc, scm_sizet (*free) (SCM));
+extern void scm_set_smob_print (long tc, int (*print) (SCM,
+                                                      SCM,
+                                                      scm_print_state*));
+extern void scm_set_smob_equalp (long tc, SCM (*equalp) (SCM, SCM));
+/* convenience function for registering multiple handler fns */
+extern void scm_set_smob_mfpe (long tc, 
+                              SCM (*mark) (SCM),
+                              scm_sizet (*free) (SCM),
+                              int (*print) (SCM, SCM, scm_print_state*),
+                              SCM (*equalp) (SCM, SCM));
+
+
+extern SCM scm_make_smob (long tc);
+extern void scm_smob_prehistory (void);
+
+/* Deprecated function */
+extern long scm_newsmob (const scm_smobfuns *smob);
 
 #endif  /* SMOBH */
+
+/*
+  Local Variables:
+  c-file-style: "gnu"
+  End:
+*/