* Get rid of calls to SCM_ROSTRINGP.
[bpt/guile.git] / libguile / ports.h
index d453073..0b12af5 100644 (file)
@@ -2,7 +2,7 @@
 
 #ifndef PORTSH
 #define PORTSH
-/*     Copyright (C) 1995,1996 Free Software Foundation, Inc.
+/*     Copyright (C) 1995,1996,1997,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.  
- */
-\f
+ * If you do not wish that, delete this exception notice.  */
 
+/* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
+   gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
+\f
 #include "libguile/__scm.h"
 
+#include "libguile/print.h"
+#include "libguile/struct.h"
+
+/* Not sure if this is a good idea.  We need it for off_t.  */
+#include <sys/types.h>
+
 \f
 
-enum scm_port_representation_type
-{
-  scm_regular_port,
-  scm_mb_port,
-  scm_wchar_port
-};
+#define SCM_INITIAL_PUTBACK_BUF_SIZE 4
 
-enum scm_string_representation_type
-{
-  scm_regular_string = scm_regular_port,
-  scm_mb_string = scm_mb_port,
-  scm_wchar_string = scm_wchar_port
+/* values for the rw_active flag.  */
+enum scm_port_rw_active {
+  SCM_PORT_NEITHER = 0,
+  SCM_PORT_READ = 1,
+  SCM_PORT_WRITE = 2
 };
 
+/* C representation of a Scheme port.  */
 
-struct scm_port_table 
+typedef struct 
 {
-  SCM port;                    /* Open port.  */
+  SCM port;                    /* Link back to the port object.  */
+  int entry;                   /* Index in port table. */
   int revealed;                        /* 0 not revealed, > 1 revealed.
                                 * Revealed ports do not get GC'd.
                                 */
+  /* data for the underlying port implementation as a raw C value. */
+  scm_bits_t stream;
 
-  SCM stream;
   SCM file_name;               /* debugging support.  */
-  int unchr;                   /* pushed back character, if any */
-
   int line_number;             /* debugging support.  */
   int column_number;           /* debugging support.  */
 
-  enum scm_port_representation_type representation;
-};
-
-extern struct scm_port_table **scm_port_table;
+  /* port buffers.  the buffer(s) are set up for all ports.  
+     in the case of string ports, the buffer is the string itself.
+     in the case of unbuffered file ports, the buffer is a
+     single char: shortbuf.  */
+
+  /* this buffer is filled from read_buf to read_end using the ptob 
+     buffer_fill.  then input requests are taken from read_pos until
+     it reaches read_end.  */
+
+  unsigned char *read_buf;     /* buffer start.  */
+  const unsigned char *read_pos;/* the next unread char.  */
+  unsigned char *read_end;      /* pointer to last buffered char + 1.  */
+  off_t read_buf_size;         /* size of the buffer.  */
+
+  /* when chars are put back into the buffer, e.g., using peek-char or
+     unread-string, the read-buffer pointers are switched to cbuf.
+     the original pointers are saved here and restored when the put-back
+     chars have been consumed.  */
+  unsigned char *saved_read_buf;
+  const unsigned char *saved_read_pos;
+  unsigned char *saved_read_end;
+  off_t saved_read_buf_size;
+
+  /* write requests are saved into this buffer at write_pos until it
+     reaches write_buf + write_buf_size, then the ptob flush is
+     called.  */
+
+  unsigned char *write_buf;     /* buffer start.  */
+  unsigned char *write_pos;     /* pointer to last buffered char + 1.  */
+  unsigned char *write_end;     /* pointer to end of buffer + 1.  */
+  off_t write_buf_size;                /* size of the buffer.  */
+
+  unsigned char shortbuf;       /* buffer for "unbuffered" streams.  */
+
+  int rw_random;                /* true if the port is random access.
+                                  implies that the buffers must be
+                                  flushed before switching between
+                                  reading and writing, seeking, etc.  */
+
+  enum scm_port_rw_active rw_active; /* for random access ports,
+                                       indicates which of the buffers
+                                       is currently in use.  can be
+                                       SCM_PORT_WRITE, SCM_PORT_READ,
+                                       or SCM_PORT_NEITHER.  */
+
+
+  /* a buffer for un-read chars and strings.  */
+  unsigned char *putback_buf;
+  int putback_buf_size;        /* allocated size of putback_buf.  */
+} scm_port;
+
+extern scm_port **scm_port_table;
 extern int scm_port_table_size; /* Number of ports in scm_port_table.  */
 
 
 \f
 
+#define SCM_EOF_OBJECT_P(x) (SCM_EQ_P ((x), SCM_EOF_VAL))
+
 /* PORT FLAGS
- * A set of flags caracterizes a port.
+ * A set of flags characterizes a port.
+ * Note that we reserve the bits 1 << 24 and above for use by the
+ * routines in the port's scm_ptobfuns structure.
  */
 #define SCM_OPN                (1L<<16) /* Is the port open? */
 #define SCM_RDNG       (2L<<16) /* Is it a readable port? */
 #define SCM_WRTNG      (4L<<16) /* Is it writable? */
-#define SCM_BUF0       (8L<<16)
-#define SCM_CRDY       (32L<<16) /* Should char-ready? return #t? */
-
-/* A mask used to clear the char-ready port flag. */
-#define SCM_CUC                0x001fffffL
-
-#define SCM_PORTP(x) (SCM_TYP7(x)==scm_tc7_port)
-#define SCM_OPPORTP(x) (((0x7f | SCM_OPN) & SCM_CAR(x))==(scm_tc7_port | SCM_OPN))
-#define SCM_OPINPORTP(x) (((0x7f | SCM_OPN | SCM_RDNG) & SCM_CAR(x))==(scm_tc7_port | SCM_OPN | SCM_RDNG))
-#define SCM_OPOUTPORTP(x) (((0x7f | SCM_OPN | SCM_WRTNG) & SCM_CAR(x))==(scm_tc7_port | SCM_OPN | SCM_WRTNG))
-#define SCM_FPORTP(x) (SCM_TYP16S(x)==scm_tc7_port)
-#define SCM_OPFPORTP(x) (((0xfeff | SCM_OPN) & SCM_CAR(x))==(scm_tc7_port | SCM_OPN))
-#define SCM_OPINFPORTP(x) (((0xfeff | SCM_OPN | SCM_RDNG) & SCM_CAR(x))==(scm_tc7_port | SCM_OPN | SCM_RDNG))
-#define SCM_OPOUTFPORTP(x) (((0xfeff | SCM_OPN | SCM_WRTNG) & SCM_CAR(x))==(scm_tc7_port | SCM_OPN | SCM_WRTNG))
-
-#define SCM_INPORTP(x) (((0x7f | SCM_RDNG) & SCM_CAR(x))==(scm_tc7_port | SCM_RDNG))
-#define SCM_OUTPORTP(x) (((0x7f | SCM_WRTNG) & SCM_CAR(x))==(scm_tc7_port | SCM_WRTNG))
-#define SCM_OPENP(x) (SCM_OPN & SCM_CAR(x))
+#define SCM_BUF0       (8L<<16) /* Is it unbuffered? */
+#define SCM_BUFLINE     (64L<<16) /* Is it line-buffered? */
+
+#define SCM_PORTP(x) (SCM_NIMP(x) && (SCM_TYP7(x)==scm_tc7_port))
+#define SCM_OPPORTP(x) (SCM_NIMP(x) && (((0x7f | SCM_OPN) & SCM_CELL_WORD_0(x))==(scm_tc7_port | SCM_OPN)))
+#define SCM_OPINPORTP(x) (SCM_NIMP(x) && (((0x7f | SCM_OPN | SCM_RDNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port | SCM_OPN | SCM_RDNG)))
+#define SCM_OPOUTPORTP(x) (SCM_NIMP(x) && (((0x7f | SCM_OPN | SCM_WRTNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port | SCM_OPN | SCM_WRTNG)))
+#define SCM_INPUT_PORT_P(x) \
+  (SCM_NIMP(x) \
+   && (((0x7f | SCM_RDNG) & SCM_CELL_WORD_0(x)) == (scm_tc7_port | SCM_RDNG)))
+#define SCM_OUTPUT_PORT_P(x) \
+  (SCM_NIMP(x) \
+   && (((0x7f | SCM_WRTNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port | SCM_WRTNG)))
+#define SCM_OPENP(x) (SCM_NIMP(x) && (SCM_OPN & SCM_CELL_WORD_0 (x)))
 #define SCM_CLOSEDP(x) (!SCM_OPENP(x))
-#define SCM_PTAB_ENTRY(x) ((struct scm_port_table *)SCM_CDR(x))
-#define SCM_SETPTAB_ENTRY(x,ent) SCM_SETCDR ((x), (SCM)(ent))
-#define SCM_STREAM(x) SCM_PTAB_ENTRY(x)->stream
-#define SCM_SETSTREAM(x,s) (SCM_PTAB_ENTRY(x)->stream = s)
-#define SCM_LINUM(x) SCM_PTAB_ENTRY(x)->line_number
-#define SCM_COL(x) SCM_PTAB_ENTRY(x)->column_number
-#define SCM_REVEALED(x) SCM_PTAB_ENTRY(x)->revealed
-#define SCM_SETREVEALED(x,s) (SCM_PTAB_ENTRY(x)->revealed = s)
-#define SCM_PORT_REPRESENTATION(x) SCM_PTAB_ENTRY(x)->representation
-#define SCM_SET_PORT_REPRESENTATION(x,s) (SCM_PTAB_ENTRY(x)->representation = s)
-#define SCM_CRDYP(port) (SCM_CAR(port) & SCM_CRDY)
-#define SCM_CLRDY(port) {SCM_CAR(port) &= SCM_CUC;}
-#define SCM_SETRDY(port) {SCM_CAR(port) |= SCM_CRDY;}
-#define SCM_CUNGET(c,port) {SCM_PTAB_ENTRY(port)->unchr = c; SCM_SETRDY(port);}
-#define SCM_CGETUN(port) (SCM_PTAB_ENTRY(port)->unchr)
+
+#define SCM_PTAB_ENTRY(x)         ((scm_port *) SCM_CELL_WORD_1 (x))
+#define SCM_SETPTAB_ENTRY(x,ent)  (SCM_SET_CELL_WORD_1 ((x), (scm_bits_t) (ent)))
+#define SCM_STREAM(x)             (SCM_PTAB_ENTRY(x)->stream)
+#define SCM_SETSTREAM(x,s)        (SCM_PTAB_ENTRY(x)->stream = (scm_bits_t) (s))
+#define SCM_FILENAME(x)           (SCM_PTAB_ENTRY(x)->file_name)
+#define SCM_SET_FILENAME(x, n)    (SCM_PTAB_ENTRY(x)->file_name = (n))
+#define SCM_LINUM(x)              (SCM_PTAB_ENTRY(x)->line_number)
+#define SCM_COL(x)                (SCM_PTAB_ENTRY(x)->column_number)
+#define SCM_REVEALED(x)           (SCM_PTAB_ENTRY(x)->revealed)
+#define SCM_SETREVEALED(x,s)      (SCM_PTAB_ENTRY(x)->revealed = (s))
 
 #define SCM_INCLINE(port)      {SCM_LINUM (port) += 1; SCM_COL (port) = 0;}
 #define SCM_INCCOL(port)       {SCM_COL (port) += 1;}
-#define SCM_TABCOL(port)       {SCM_COL (port) += (SCM_COL (port) + 1) % 8;}
-
-
+#define SCM_TABCOL(port)       {SCM_COL (port) += 8 - SCM_COL (port) % 8;}
 
 \f
 
-typedef struct scm_ptobfuns
+/* port-type description.  */
+typedef struct scm_ptob_descriptor
 {
-  SCM (*mark) ();
-  int (*free) ();
-  int (*print) ();
-  SCM (*equalp) ();
-  int (*fputc) ();
-  int (*fputs) ();
-  scm_sizet (*fwrite) ();
-  int (*fflush) ();
-  int (*fgetc) ();
-  int (*fclose) ();
-} scm_ptobfuns;
-
-#define SCM_PTOBNUM(x) (0x0ff & (SCM_CAR(x)>>8));
+  char *name;
+  SCM (*mark) (SCM);
+  scm_sizet (*free) (SCM);
+  int (*print) (SCM exp, SCM port, scm_print_state *pstate);
+  SCM (*equalp) (SCM, SCM);
+  int (*close) (SCM port);
+
+  void (*write) (SCM port, const void *data, size_t size);
+  void (*flush) (SCM port);
+
+  void (*end_input) (SCM port, int offset);
+  int (*fill_input) (SCM port);
+  int (*input_waiting) (SCM port);
+
+  off_t (*seek) (SCM port, off_t OFFSET, int WHENCE);
+  void (*truncate) (SCM port, off_t length);
+
+} scm_ptob_descriptor;
+
+#define SCM_TC2PTOBNUM(x) (0x0ff & ((x) >> 8))
+#define SCM_PTOBNUM(x) (SCM_TC2PTOBNUM (SCM_CELL_TYPE (x)))
+/* SCM_PTOBNAME can be 0 if name is missing */
+#define SCM_PTOBNAME(ptobnum) scm_ptobs[ptobnum].name
 
 \f
 
-extern scm_ptobfuns *scm_ptobs;
-extern scm_sizet scm_numptob;
+extern scm_ptob_descriptor *scm_ptobs;
+extern int scm_numptob;
 extern int scm_port_table_room;
 
 \f
-#ifdef __STDC__
+
 extern SCM scm_markstream (SCM ptr);
-extern long scm_newptob (scm_ptobfuns *ptob);
-extern void scm_fflush (SCM port);
+extern long scm_make_port_type (char *name,
+                               int (*fill_input) (SCM port),
+                               void (*write) (SCM port, const void *data,
+                                              size_t size));
+extern void scm_set_port_mark (long tc, SCM (*mark) (SCM));
+extern void scm_set_port_free (long tc, scm_sizet (*free) (SCM));
+extern void scm_set_port_print (long tc,
+                               int (*print) (SCM exp,
+                                             SCM port,
+                                             scm_print_state *pstate));
+extern void scm_set_port_equalp (long tc, SCM (*equalp) (SCM, SCM));
+extern void scm_set_port_close (long tc, int (*close) (SCM));
+
+extern void scm_set_port_flush (long tc, 
+                               void (*flush) (SCM port));
+extern void scm_set_port_end_input (long tc,
+                                   void (*end_input) (SCM port,
+                                                      int offset));
+extern void scm_set_port_seek (long tc,
+                              off_t (*seek) (SCM port,
+                                             off_t OFFSET,
+                                             int WHENCE));
+extern void scm_set_port_truncate (long tc,
+                                  void (*truncate) (SCM port,
+                                                    off_t length));
+extern void scm_set_port_input_waiting (long tc, int (*input_waiting) (SCM));
 extern SCM scm_char_ready_p (SCM port);
-extern SCM scm_ungetc_char_ready_p (SCM port);
+extern SCM scm_drain_input (SCM port);
 extern SCM scm_current_input_port (void);
 extern SCM scm_current_output_port (void);
 extern SCM scm_current_error_port (void);
+extern SCM scm_current_load_port (void);
 extern SCM scm_set_current_input_port (SCM port);
 extern SCM scm_set_current_output_port (SCM port);
 extern SCM scm_set_current_error_port (SCM port);
-extern struct scm_port_table * scm_add_to_port_table (SCM port);
+extern scm_port * scm_add_to_port_table (SCM port);
 extern void scm_remove_from_port_table (SCM port);
+extern void scm_grow_port_cbuf (SCM port, size_t requested);
 extern SCM scm_pt_size (void);
 extern SCM scm_pt_member (SCM member);
+extern void scm_port_non_buffer (scm_port *pt);
 extern int scm_revealed_count (SCM port);
 extern SCM scm_port_revealed (SCM port);
 extern SCM scm_set_port_revealed_x (SCM port, SCM rcount);
+extern long scm_mode_bits (char *modes);
+extern SCM scm_port_mode (SCM port);
+extern SCM scm_close_input_port (SCM port);
+extern SCM scm_close_output_port (SCM port);
 extern SCM scm_close_port (SCM port);
 extern SCM scm_close_all_ports_except (SCM ports);
 extern SCM scm_input_port_p (SCM x);
 extern SCM scm_output_port_p (SCM x);
+extern SCM scm_port_closed_p (SCM port);
 extern SCM scm_eof_object_p (SCM x);
 extern SCM scm_force_output (SCM port);
+extern SCM scm_flush_all_ports (void);
 extern SCM scm_read_char (SCM port);
+extern void scm_putc (char c, SCM port);
+extern void scm_puts (const char *str_data, SCM port);
+extern void scm_lfwrite (const char *ptr, scm_sizet size, SCM port);
+extern void scm_flush (SCM port);
+extern void scm_end_input (SCM port);
+extern int scm_fill_input (SCM port);
+extern int scm_getc (SCM port);
+extern void scm_ungetc (int c, SCM port);
+extern void scm_ungets (const char *s, int n, SCM port);
 extern SCM scm_peek_char (SCM port);
 extern SCM scm_unread_char (SCM cobj, SCM port);
-extern SCM scm_line_number (SCM port);
-extern SCM scm_column_number (SCM port);
-/* extern SCM scm_port_file_name (SCM port); */
-extern void scm_prinport (SCM exp, SCM port, char *type);
+extern SCM scm_unread_string (SCM str, SCM port);
+extern SCM scm_seek (SCM object, SCM offset, SCM whence);
+extern SCM scm_truncate_file (SCM object, SCM length);
+extern SCM scm_port_line (SCM port);
+extern SCM scm_set_port_line_x (SCM port, SCM line);
+extern SCM scm_port_column (SCM port);
+extern SCM scm_set_port_column_x (SCM port, SCM line);
+extern SCM scm_port_filename (SCM port);
+extern SCM scm_set_port_filename_x (SCM port, SCM filename);
+extern int scm_port_print (SCM exp, SCM port, scm_print_state *);
+extern void scm_print_port_mode (SCM exp, SCM port);
 extern void scm_ports_prehistory (void);
 extern SCM scm_void_port (char * mode_str);
 extern SCM scm_sys_make_void_port (SCM mode);
 extern void scm_init_ports (void);
 
-#else /* STDC */
-extern SCM scm_markstream ();
-extern long scm_newptob ();
-extern void scm_fflush ();
-extern SCM scm_char_ready_p ();
-extern SCM scm_ungetc_char_ready_p ();
-extern SCM scm_current_input_port ();
-extern SCM scm_current_output_port ();
-extern SCM scm_current_error_port ();
-extern SCM scm_set_current_input_port ();
-extern SCM scm_set_current_output_port ();
-extern SCM scm_set_current_error_port ();
-extern struct scm_port_table * scm_add_to_port_table ();
-extern void scm_remove_from_port_table ();
-extern SCM scm_pt_size ();
-extern SCM scm_pt_member ();
-extern int scm_revealed_count ();
-extern SCM scm_port_revealed ();
-extern SCM scm_set_port_revealed_x ();
-extern SCM scm_close_port ();
-extern SCM scm_close_all_ports_except ();
-extern SCM scm_input_port_p ();
-extern SCM scm_output_port_p ();
-extern SCM scm_eof_object_p ();
-extern SCM scm_force_output ();
-extern SCM scm_read_char ();
-extern SCM scm_peek_char ();
-extern SCM scm_unread_char ();
-extern SCM scm_line_number ();
-extern SCM scm_column_number ();
-/* extern SCM scm_port_file_name ();*/
-extern void scm_prinport ();
-extern void scm_ports_prehistory ();
-extern SCM scm_void_port ();
-extern SCM scm_sys_make_void_port ();
-extern void scm_init_ports ();
-
-#endif /* STDC */
-
-
-
-
-
-
-
+#ifdef GUILE_DEBUG
+extern SCM scm_pt_size (void);
+extern SCM scm_pt_member (SCM member);
+#endif /* GUILE_DEBUG */
 
+\f
 
+#if (SCM_DEBUG_DEPRECATED == 0)
 
+/* #define SCM_CRDY    (32L<<16)  obsolete, for pushed back characters  */
+#define SCM_INPORTP(x) SCM_INPUT_PORT_P (x)
+#define SCM_OUTPORTP(x) SCM_OUTPUT_PORT_P (x)
 
+#endif  /* SCM_DEBUG_DEPRECATED == 0 */
 
 #endif  /* PORTSH */
+
+/*
+  Local Variables:
+  c-file-style: "gnu"
+  End:
+*/