[bpt/guile.git] / libguile / ports.h

/* classes: h_files */

#ifndef SCM_PORTS_H
#define SCM_PORTS_H

/* Copyright (C) 1995,1996,1997,1998,1999,2000,2001, 2003, 2004 Free Software Foundation, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

\f

#include "libguile/__scm.h"

#include "libguile/print.h"
#include "libguile/struct.h"
#include "libguile/threads.h"

/* Not sure if this is a good idea.  We need it for off_t.  */
#include <sys/types.h>

\f

#define SCM_INITIAL_PUTBACK_BUF_SIZE 4

/* values for the rw_active flag.  */
typedef enum scm_t_port_rw_active {
  SCM_PORT_NEITHER = 0,
  SCM_PORT_READ = 1,
  SCM_PORT_WRITE = 2
} scm_t_port_rw_active;

/* C representation of a Scheme port.  */

typedef struct 
{
  SCM port;			/* Link back to the port object.  */
  long 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_t_bits stream;

  SCM file_name;		/* debugging support.  */
  long line_number;		/* debugging support.  */
  int column_number;		/* debugging support.  */

  /* 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.  */

  scm_t_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;
  size_t putback_buf_size;        /* allocated size of putback_buf.  */
} scm_t_port;

SCM_API scm_t_port **scm_i_port_table;
SCM_API long scm_i_port_table_size; /* Number of ports in scm_i_port_table.  */
SCM_API scm_i_pthread_mutex_t scm_i_port_table_mutex;

#define SCM_READ_BUFFER_EMPTY_P(c_port) (c_port->read_pos >= c_port->read_end)

\f

#define SCM_EOF_OBJECT_P(x) (scm_is_eq ((x), SCM_EOF_VAL))

/* PORT FLAGS
 * 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) /* Is it unbuffered? */
#define SCM_BUFLINE     (64L<<16) /* Is it line-buffered? */

#define SCM_PORTP(x) (!SCM_IMP (x) && (SCM_TYP7 (x) == scm_tc7_port))
#define SCM_OPPORTP(x) (!SCM_IMP(x) && (((0x7f | SCM_OPN) & SCM_CELL_WORD_0(x))==(scm_tc7_port | SCM_OPN)))
#define SCM_OPINPORTP(x) (!SCM_IMP(x) && (((0x7f | SCM_OPN | SCM_RDNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port | SCM_OPN | SCM_RDNG)))
#define SCM_OPOUTPORTP(x) (!SCM_IMP(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_IMP(x) \
   && (((0x7f | SCM_RDNG) & SCM_CELL_WORD_0(x)) == (scm_tc7_port | SCM_RDNG)))
#define SCM_OUTPUT_PORT_P(x) \
  (!SCM_IMP(x) \
   && (((0x7f | SCM_WRTNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port | SCM_WRTNG)))
#define SCM_OPENP(x) (!SCM_IMP(x) && (SCM_OPN & SCM_CELL_WORD_0 (x)))
#define SCM_CLOSEDP(x) (!SCM_OPENP(x))
#define SCM_CLR_PORT_OPEN_FLAG(p) \
  SCM_SET_CELL_WORD_0 ((p), SCM_CELL_WORD_0 (p) & ~SCM_OPN)

#define SCM_PTAB_ENTRY(x)         ((scm_t_port *) SCM_CELL_WORD_1 (x))
#define SCM_SETPTAB_ENTRY(x, ent)  (SCM_SET_CELL_WORD_1 ((x), (scm_t_bits) (ent)))
#define SCM_STREAM(x)             (SCM_PTAB_ENTRY(x)->stream)
#define SCM_SETSTREAM(x, s)        (SCM_PTAB_ENTRY(x)->stream = (scm_t_bits) (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_ZEROCOL(port)  	{SCM_COL (port) = 0;}
#define SCM_INCCOL(port)  	{SCM_COL (port) += 1;}
#define SCM_DECCOL(port)  	{if (SCM_COL (port) > 0) SCM_COL (port) -= 1;}
#define SCM_TABCOL(port)  	{SCM_COL (port) += 8 - SCM_COL (port) % 8;}

\f

/* port-type description.  */
typedef struct scm_t_ptob_descriptor
{
  char *name;
  SCM (*mark) (SCM);
  size_t (*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_t_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

SCM_API scm_t_ptob_descriptor *scm_ptobs;
SCM_API long scm_numptob;
SCM_API long scm_i_port_table_room;

\f

SCM_API SCM scm_markstream (SCM ptr);
SCM_API scm_t_bits scm_make_port_type (char *name,
				       int (*fill_input) (SCM port),
				       void (*write) (SCM port, 
						      const void *data,
						      size_t size));
SCM_API void scm_set_port_mark (long tc, SCM (*mark) (SCM));
SCM_API void scm_set_port_free (long tc, size_t (*free) (SCM));
SCM_API void scm_set_port_print (long tc,
				 int (*print) (SCM exp,
					       SCM port,
					       scm_print_state *pstate));
SCM_API void scm_set_port_equalp (long tc, SCM (*equalp) (SCM, SCM));
SCM_API void scm_set_port_close (long tc, int (*close) (SCM));

SCM_API void scm_set_port_flush (long tc, 
				 void (*flush) (SCM port));
SCM_API void scm_set_port_end_input (long tc,
				     void (*end_input) (SCM port,
							int offset));
SCM_API void scm_set_port_seek (long tc,
				off_t (*seek) (SCM port,
					       off_t OFFSET,
					       int WHENCE));
SCM_API void scm_set_port_truncate (long tc,
				    void (*truncate) (SCM port,
						      off_t length));
SCM_API void scm_set_port_input_waiting (long tc, int (*input_waiting) (SCM));
SCM_API SCM scm_char_ready_p (SCM port);
size_t scm_take_from_input_buffers (SCM port, char *dest, size_t read_len);
SCM_API SCM scm_drain_input (SCM port);
SCM_API SCM scm_current_input_port (void);
SCM_API SCM scm_current_output_port (void);
SCM_API SCM scm_current_error_port (void);
SCM_API SCM scm_current_load_port (void);
SCM_API SCM scm_set_current_input_port (SCM port);
SCM_API SCM scm_set_current_output_port (SCM port);
SCM_API SCM scm_set_current_error_port (SCM port);
SCM_API void scm_dynwind_current_input_port (SCM port);
SCM_API void scm_dynwind_current_output_port (SCM port);
SCM_API void scm_dynwind_current_error_port (SCM port);
SCM_API SCM scm_new_port_table_entry (scm_t_bits tag);
SCM_API void scm_remove_from_port_table (SCM port);
SCM_API void scm_grow_port_cbuf (SCM port, size_t requested);
SCM_API SCM scm_pt_size (void);
SCM_API SCM scm_pt_member (SCM member);
SCM_API void scm_port_non_buffer (scm_t_port *pt);
SCM_API int scm_revealed_count (SCM port);
SCM_API SCM scm_port_revealed (SCM port);
SCM_API SCM scm_set_port_revealed_x (SCM port, SCM rcount);
SCM_API long scm_mode_bits (char *modes);
SCM_API SCM scm_port_mode (SCM port);
SCM_API SCM scm_close_input_port (SCM port);
SCM_API SCM scm_close_output_port (SCM port);
SCM_API SCM scm_close_port (SCM port);
SCM_API SCM scm_port_for_each (SCM proc);
SCM_API void scm_c_port_for_each (void (*proc)(void *data, SCM p), void *data);
SCM_API SCM scm_input_port_p (SCM x);
SCM_API SCM scm_output_port_p (SCM x);
SCM_API SCM scm_port_p (SCM x);
SCM_API SCM scm_port_closed_p (SCM port);
SCM_API SCM scm_eof_object_p (SCM x);
SCM_API SCM scm_force_output (SCM port);
SCM_API SCM scm_flush_all_ports (void);
SCM_API SCM scm_read_char (SCM port);
SCM_API void scm_putc (char c, SCM port);
SCM_API void scm_puts (const char *str_data, SCM port);
SCM_API size_t scm_c_read (SCM port, void *buffer, size_t size);
SCM_API void scm_c_write (SCM port, const void *buffer, size_t size);
SCM_API void scm_lfwrite (const char *ptr, size_t size, SCM port);
SCM_API void scm_flush (SCM port);
SCM_API void scm_end_input (SCM port);
SCM_API int scm_fill_input (SCM port);
SCM_API int scm_getc (SCM port);
SCM_API void scm_ungetc (int c, SCM port);
SCM_API void scm_ungets (const char *s, int n, SCM port);
SCM_API SCM scm_peek_char (SCM port);
SCM_API SCM scm_unread_char (SCM cobj, SCM port);
SCM_API SCM scm_unread_string (SCM str, SCM port);
SCM_API SCM scm_seek (SCM object, SCM offset, SCM whence);
SCM_API SCM scm_truncate_file (SCM object, SCM length);
SCM_API SCM scm_port_line (SCM port);
SCM_API SCM scm_set_port_line_x (SCM port, SCM line);
SCM_API SCM scm_port_column (SCM port);
SCM_API SCM scm_set_port_column_x (SCM port, SCM line);
SCM_API SCM scm_port_filename (SCM port);
SCM_API SCM scm_set_port_filename_x (SCM port, SCM filename);
SCM_API int scm_port_print (SCM exp, SCM port, scm_print_state *);
SCM_API void scm_print_port_mode (SCM exp, SCM port);
SCM_API void scm_ports_prehistory (void);
SCM_API SCM scm_void_port (char * mode_str);
SCM_API SCM scm_sys_make_void_port (SCM mode);
SCM_API void scm_init_ports (void);


#if SCM_ENABLE_DEPRECATED==1
SCM_API scm_t_port * scm_add_to_port_table (SCM port);
#endif

#ifdef GUILE_DEBUG
SCM_API SCM scm_pt_size (void);
SCM_API SCM scm_pt_member (SCM member);
#endif /* GUILE_DEBUG */

/* internal */

SCM_API long scm_i_mode_bits (SCM modes);
SCM_API void scm_i_dynwind_current_load_port (SCM port);


#endif  /* SCM_PORTS_H */

/*
  Local Variables:
  c-file-style: "gnu"
  End:
*/
Commit	Line	Data
0f2d19dd JB	1	/* classes: h_files */
0f2d19dd JB	2
22a52da1 DH	3	#ifndef SCM_PORTS_H
22a52da1 DH	4	#define SCM_PORTS_H
8c494e99	5
185e369a	6	/* Copyright (C) 1995,1996,1997,1998,1999,2000,2001, 2003, 2004 Free Software Foundation, Inc.
8c494e99	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.
8c494e99	12	*
73be1d9e	13	* This library is distributed in the hope that it will be useful,
0f2d19dd	14	* but WITHOUT ANY WARRANTY; without even the implied warranty of
73be1d9e MV	15	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
73be1d9e MV	16	* Lesser General Public License for more details.
8c494e99	17	*
73be1d9e MV	18	* You should have received a copy of the GNU Lesser General Public
73be1d9e MV	19	* License along with this library; if not, write to the Free Software
92205699	20	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
73be1d9e	21	*/
d3a6bc94	22
0f2d19dd	23	\f
8c494e99	24
b4309c3c	25	#include "libguile/__scm.h"
0f2d19dd	26
e0d86ad2	27	#include "libguile/print.h"
78446828	28	#include "libguile/struct.h"
b9ad392e	29	#include "libguile/threads.h"
e0d86ad2	30
acdb12da JB	31	/* Not sure if this is a good idea. We need it for off_t. */
	32	#include <sys/types.h>
	33
0f2d19dd JB	34	\f
0f2d19dd JB	35
6c951427	36	#define SCM_INITIAL_PUTBACK_BUF_SIZE 4
0855ef71	37
61e452ba	38	/* values for the rw_active flag. */
92c2555f	39	typedef enum scm_t_port_rw_active {
61e452ba JB	40	SCM_PORT_NEITHER = 0,
	41	SCM_PORT_READ = 1,
	42	SCM_PORT_WRITE = 2
92c2555f	43	} scm_t_port_rw_active;
61e452ba	44
840ae05d JB	45	/* C representation of a Scheme port. */
	46
	47	typedef struct
0f2d19dd	48	{
ee149d03	49	SCM port; /* Link back to the port object. */
c014a02e	50	long entry; /* Index in port table. */
0f2d19dd JB	51	int revealed; /* 0 not revealed, > 1 revealed.
	52	* Revealed ports do not get GC'd.
	53	*/
74a16888	54	/* data for the underlying port implementation as a raw C value. */
92c2555f	55	scm_t_bits stream;
0f2d19dd	56
0855ef71	57	SCM file_name; /* debugging support. */
1be6b49c	58	long line_number; /* debugging support. */
ebf7394e	59	int column_number; /* debugging support. */
0855ef71	60
ee149d03 JB	61	/* port buffers. the buffer(s) are set up for all ports.
	62	in the case of string ports, the buffer is the string itself.
	63	in the case of unbuffered file ports, the buffer is a
	64	single char: shortbuf. */
	65
	66	/* this buffer is filled from read_buf to read_end using the ptob
	67	buffer_fill. then input requests are taken from read_pos until
	68	it reaches read_end. */
	69
	70	unsigned char read_buf; / buffer start. */
840ae05d	71	const unsigned char read_pos;/ the next unread char. */
ee149d03	72	unsigned char read_end; / pointer to last buffered char + 1. */
840ae05d	73	off_t read_buf_size; /* size of the buffer. */
ee149d03	74
6c951427 GH	75	/* when chars are put back into the buffer, e.g., using peek-char or
	76	unread-string, the read-buffer pointers are switched to cbuf.
	77	the original pointers are saved here and restored when the put-back
	78	chars have been consumed. */
	79	unsigned char *saved_read_buf;
	80	const unsigned char *saved_read_pos;
	81	unsigned char *saved_read_end;
	82	off_t saved_read_buf_size;
	83
ee149d03 JB	84	/* write requests are saved into this buffer at write_pos until it
	85	reaches write_buf + write_buf_size, then the ptob flush is
	86	called. */
	87
6c951427	88	unsigned char write_buf; / buffer start. */
ee149d03 JB	89	unsigned char write_pos; / pointer to last buffered char + 1. */
ee149d03 JB	90	unsigned char write_end; / pointer to end of buffer + 1. */
840ae05d	91	off_t write_buf_size; /* size of the buffer. */
ee149d03 JB	92
	93	unsigned char shortbuf; /* buffer for "unbuffered" streams. */
	94
0de97b83 GH	95	int rw_random; /* true if the port is random access.
	96	implies that the buffers must be
	97	flushed before switching between
	98	reading and writing, seeking, etc. */
	99
92c2555f	100	scm_t_port_rw_active rw_active; /* for random access ports,
1be6b49c ML	101	indicates which of the buffers
	102	is currently in use. can be
	103	SCM_PORT_WRITE, SCM_PORT_READ,
	104	or SCM_PORT_NEITHER. */
ee149d03	105
61e452ba	106
6c951427 GH	107	/* a buffer for un-read chars and strings. */
6c951427 GH	108	unsigned char *putback_buf;
1be6b49c	109	size_t putback_buf_size; /* allocated size of putback_buf. */
92c2555f	110	} scm_t_port;
840ae05d	111
67329a9e HWN	112	SCM_API scm_t_port **scm_i_port_table;
67329a9e HWN	113	SCM_API long scm_i_port_table_size; /* Number of ports in scm_i_port_table. */
9de87eea	114	SCM_API scm_i_pthread_mutex_t scm_i_port_table_mutex;
0f2d19dd	115
6fe692e9	116	#define SCM_READ_BUFFER_EMPTY_P(c_port) (c_port->read_pos >= c_port->read_end)
0f2d19dd JB	117
	118	\f
	119
bc36d050	120	#define SCM_EOF_OBJECT_P(x) (scm_is_eq ((x), SCM_EOF_VAL))
0c32d76c	121
0f2d19dd	122	/* PORT FLAGS
dbece3a2	123	* A set of flags characterizes a port.
571031dc JB	124	* Note that we reserve the bits 1 << 24 and above for use by the
571031dc JB	125	* routines in the port's scm_ptobfuns structure.
0f2d19dd JB	126	*/
	127	#define SCM_OPN (1L<<16) /* Is the port open? */
	128	#define SCM_RDNG (2L<<16) /* Is it a readable port? */
	129	#define SCM_WRTNG (4L<<16) /* Is it writable? */
ee149d03	130	#define SCM_BUF0 (8L<<16) /* Is it unbuffered? */
ee149d03	131	#define SCM_BUFLINE (64L<<16) /* Is it line-buffered? */
0f2d19dd	132
8c494e99 DH	133	#define SCM_PORTP(x) (!SCM_IMP (x) && (SCM_TYP7 (x) == scm_tc7_port))
	134	#define SCM_OPPORTP(x) (!SCM_IMP(x) && (((0x7f \| SCM_OPN) & SCM_CELL_WORD_0(x))==(scm_tc7_port \| SCM_OPN)))
	135	#define SCM_OPINPORTP(x) (!SCM_IMP(x) && (((0x7f \| SCM_OPN \| SCM_RDNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port \| SCM_OPN \| SCM_RDNG)))
	136	#define SCM_OPOUTPORTP(x) (!SCM_IMP(x) && (((0x7f \| SCM_OPN \| SCM_WRTNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port \| SCM_OPN \| SCM_WRTNG)))
df97587f	137	#define SCM_INPUT_PORT_P(x) \
8c494e99	138	(!SCM_IMP(x) \
f9a64404	139	&& (((0x7f \| SCM_RDNG) & SCM_CELL_WORD_0(x)) == (scm_tc7_port \| SCM_RDNG)))
df97587f	140	#define SCM_OUTPUT_PORT_P(x) \
8c494e99	141	(!SCM_IMP(x) \
f9a64404	142	&& (((0x7f \| SCM_WRTNG) & SCM_CELL_WORD_0(x))==(scm_tc7_port \| SCM_WRTNG)))
8c494e99	143	#define SCM_OPENP(x) (!SCM_IMP(x) && (SCM_OPN & SCM_CELL_WORD_0 (x)))
0f2d19dd	144	#define SCM_CLOSEDP(x) (!SCM_OPENP(x))
22a52da1 DH	145	#define SCM_CLR_PORT_OPEN_FLAG(p) \
22a52da1 DH	146	SCM_SET_CELL_WORD_0 ((p), SCM_CELL_WORD_0 (p) & ~SCM_OPN)
843524cc	147
92c2555f	148	#define SCM_PTAB_ENTRY(x) ((scm_t_port *) SCM_CELL_WORD_1 (x))
34d19ef6	149	#define SCM_SETPTAB_ENTRY(x, ent) (SCM_SET_CELL_WORD_1 ((x), (scm_t_bits) (ent)))
843524cc	150	#define SCM_STREAM(x) (SCM_PTAB_ENTRY(x)->stream)
34d19ef6	151	#define SCM_SETSTREAM(x, s) (SCM_PTAB_ENTRY(x)->stream = (scm_t_bits) (s))
843524cc	152	#define SCM_FILENAME(x) (SCM_PTAB_ENTRY(x)->file_name)
b24b5e13	153	#define SCM_SET_FILENAME(x, n) (SCM_PTAB_ENTRY(x)->file_name = (n))
843524cc DH	154	#define SCM_LINUM(x) (SCM_PTAB_ENTRY(x)->line_number)
	155	#define SCM_COL(x) (SCM_PTAB_ENTRY(x)->column_number)
	156	#define SCM_REVEALED(x) (SCM_PTAB_ENTRY(x)->revealed)
34d19ef6	157	#define SCM_SETREVEALED(x, s) (SCM_PTAB_ENTRY(x)->revealed = (s))
0f2d19dd JB	158
0f2d19dd JB	159	#define SCM_INCLINE(port) {SCM_LINUM (port) += 1; SCM_COL (port) = 0;}
92680388	160	#define SCM_ZEROCOL(port) {SCM_COL (port) = 0;}
0f2d19dd	161	#define SCM_INCCOL(port) {SCM_COL (port) += 1;}
92680388	162	#define SCM_DECCOL(port) {if (SCM_COL (port) > 0) SCM_COL (port) -= 1;}
d14af9f2	163	#define SCM_TABCOL(port) {SCM_COL (port) += 8 - SCM_COL (port) % 8;}
0f2d19dd	164
0f2d19dd JB	165	\f
0f2d19dd JB	166
affc96b5	167	/* port-type description. */
92c2555f	168	typedef struct scm_t_ptob_descriptor
0f82baf6	169	{
f12733c9	170	char *name;
0c0669cc	171	SCM (*mark) (SCM);
1be6b49c	172	size_t (*free) (SCM);
0c0669cc JB	173	int (print) (SCM exp, SCM port, scm_print_state pstate);
0c0669cc JB	174	SCM (*equalp) (SCM, SCM);
affc96b5 GH	175	int (*close) (SCM port);
affc96b5 GH	176
8aa011a1	177	void (write) (SCM port, const void data, size_t size);
affc96b5 GH	178	void (*flush) (SCM port);
	179
	180	void (*end_input) (SCM port, int offset);
	181	int (*fill_input) (SCM port);
	182	int (*input_waiting) (SCM port);
	183
ee149d03	184	off_t (*seek) (SCM port, off_t OFFSET, int WHENCE);
affc96b5 GH	185	void (*truncate) (SCM port, off_t length);
affc96b5 GH	186
92c2555f	187	} scm_t_ptob_descriptor;
1be6b49c	188
12a8b769 DH	189	#define SCM_TC2PTOBNUM(x) (0x0ff & ((x) >> 8))
12a8b769 DH	190	#define SCM_PTOBNUM(x) (SCM_TC2PTOBNUM (SCM_CELL_TYPE (x)))
f12733c9 MD	191	/* SCM_PTOBNAME can be 0 if name is missing */
f12733c9 MD	192	#define SCM_PTOBNAME(ptobnum) scm_ptobs[ptobnum].name
0f82baf6 JB	193
	194	\f
	195
33b001fd MV	196	SCM_API scm_t_ptob_descriptor *scm_ptobs;
33b001fd MV	197	SCM_API long scm_numptob;
67329a9e	198	SCM_API long scm_i_port_table_room;
0f2d19dd JB	199
0f2d19dd JB	200	\f
0f2d19dd	201
33b001fd MV	202	SCM_API SCM scm_markstream (SCM ptr);
	203	SCM_API scm_t_bits scm_make_port_type (char *name,
	204	int (*fill_input) (SCM port),
	205	void (*write) (SCM port,
	206	const void *data,
	207	size_t size));
	208	SCM_API void scm_set_port_mark (long tc, SCM (*mark) (SCM));
	209	SCM_API void scm_set_port_free (long tc, size_t (*free) (SCM));
	210	SCM_API void scm_set_port_print (long tc,
	211	int (*print) (SCM exp,
	212	SCM port,
	213	scm_print_state *pstate));
	214	SCM_API void scm_set_port_equalp (long tc, SCM (*equalp) (SCM, SCM));
	215	SCM_API void scm_set_port_close (long tc, int (*close) (SCM));
	216
	217	SCM_API void scm_set_port_flush (long tc,
	218	void (*flush) (SCM port));
	219	SCM_API void scm_set_port_end_input (long tc,
	220	void (*end_input) (SCM port,
	221	int offset));
	222	SCM_API void scm_set_port_seek (long tc,
	223	off_t (*seek) (SCM port,
	224	off_t OFFSET,
	225	int WHENCE));
	226	SCM_API void scm_set_port_truncate (long tc,
	227	void (*truncate) (SCM port,
	228	off_t length));
	229	SCM_API void scm_set_port_input_waiting (long tc, int (*input_waiting) (SCM));
	230	SCM_API SCM scm_char_ready_p (SCM port);
c2da2648	231	size_t scm_take_from_input_buffers (SCM port, char *dest, size_t read_len);
33b001fd MV	232	SCM_API SCM scm_drain_input (SCM port);
	233	SCM_API SCM scm_current_input_port (void);
	234	SCM_API SCM scm_current_output_port (void);
	235	SCM_API SCM scm_current_error_port (void);
	236	SCM_API SCM scm_current_load_port (void);
	237	SCM_API SCM scm_set_current_input_port (SCM port);
	238	SCM_API SCM scm_set_current_output_port (SCM port);
	239	SCM_API SCM scm_set_current_error_port (SCM port);
661ae7ab MV	240	SCM_API void scm_dynwind_current_input_port (SCM port);
	241	SCM_API void scm_dynwind_current_output_port (SCM port);
	242	SCM_API void scm_dynwind_current_error_port (SCM port);
da220f27	243	SCM_API SCM scm_new_port_table_entry (scm_t_bits tag);
33b001fd MV	244	SCM_API void scm_remove_from_port_table (SCM port);
	245	SCM_API void scm_grow_port_cbuf (SCM port, size_t requested);
	246	SCM_API SCM scm_pt_size (void);
	247	SCM_API SCM scm_pt_member (SCM member);
	248	SCM_API void scm_port_non_buffer (scm_t_port *pt);
	249	SCM_API int scm_revealed_count (SCM port);
	250	SCM_API SCM scm_port_revealed (SCM port);
	251	SCM_API SCM scm_set_port_revealed_x (SCM port, SCM rcount);
	252	SCM_API long scm_mode_bits (char *modes);
	253	SCM_API SCM scm_port_mode (SCM port);
	254	SCM_API SCM scm_close_input_port (SCM port);
	255	SCM_API SCM scm_close_output_port (SCM port);
	256	SCM_API SCM scm_close_port (SCM port);
	257	SCM_API SCM scm_port_for_each (SCM proc);
c536b4b3	258	SCM_API void scm_c_port_for_each (void (proc)(void data, SCM p), void *data);
33b001fd MV	259	SCM_API SCM scm_input_port_p (SCM x);
	260	SCM_API SCM scm_output_port_p (SCM x);
	261	SCM_API SCM scm_port_p (SCM x);
	262	SCM_API SCM scm_port_closed_p (SCM port);
	263	SCM_API SCM scm_eof_object_p (SCM x);
	264	SCM_API SCM scm_force_output (SCM port);
	265	SCM_API SCM scm_flush_all_ports (void);
	266	SCM_API SCM scm_read_char (SCM port);
	267	SCM_API void scm_putc (char c, SCM port);
	268	SCM_API void scm_puts (const char *str_data, SCM port);
	269	SCM_API size_t scm_c_read (SCM port, void *buffer, size_t size);
	270	SCM_API void scm_c_write (SCM port, const void *buffer, size_t size);
	271	SCM_API void scm_lfwrite (const char *ptr, size_t size, SCM port);
	272	SCM_API void scm_flush (SCM port);
	273	SCM_API void scm_end_input (SCM port);
	274	SCM_API int scm_fill_input (SCM port);
	275	SCM_API int scm_getc (SCM port);
	276	SCM_API void scm_ungetc (int c, SCM port);
	277	SCM_API void scm_ungets (const char *s, int n, SCM port);
	278	SCM_API SCM scm_peek_char (SCM port);
	279	SCM_API SCM scm_unread_char (SCM cobj, SCM port);
	280	SCM_API SCM scm_unread_string (SCM str, SCM port);
	281	SCM_API SCM scm_seek (SCM object, SCM offset, SCM whence);
	282	SCM_API SCM scm_truncate_file (SCM object, SCM length);
	283	SCM_API SCM scm_port_line (SCM port);
	284	SCM_API SCM scm_set_port_line_x (SCM port, SCM line);
	285	SCM_API SCM scm_port_column (SCM port);
	286	SCM_API SCM scm_set_port_column_x (SCM port, SCM line);
	287	SCM_API SCM scm_port_filename (SCM port);
	288	SCM_API SCM scm_set_port_filename_x (SCM port, SCM filename);
	289	SCM_API int scm_port_print (SCM exp, SCM port, scm_print_state *);
	290	SCM_API void scm_print_port_mode (SCM exp, SCM port);
	291	SCM_API void scm_ports_prehistory (void);
	292	SCM_API SCM scm_void_port (char * mode_str);
	293	SCM_API SCM scm_sys_make_void_port (SCM mode);
	294	SCM_API void scm_init_ports (void);
0f2d19dd	295
67329a9e HWN	296
	297	#if SCM_ENABLE_DEPRECATED==1
	298	SCM_API scm_t_port * scm_add_to_port_table (SCM port);
	299	#endif
	300
f3667f52	301	#ifdef GUILE_DEBUG
33b001fd MV	302	SCM_API SCM scm_pt_size (void);
33b001fd MV	303	SCM_API SCM scm_pt_member (SCM member);
be1cd096	304	#endif /* GUILE_DEBUG */
f3667f52	305
d617ee18 MV	306	/* internal */
	307
	308	SCM_API long scm_i_mode_bits (SCM modes);
661ae7ab	309	SCM_API void scm_i_dynwind_current_load_port (SCM port);
d617ee18 MV	310
d617ee18 MV	311
22a52da1	312	#endif /* SCM_PORTS_H */
89e00824 ML	313
	314	/*
	315	Local Variables:
	316	c-file-style: "gnu"
	317	End:
	318	*/