(scm_primitive_load_path): Do not check for absolute filenames when
[bpt/guile.git] / libguile / ports.h
CommitLineData
0f2d19dd
JB
1/* classes: h_files */
2
22a52da1
DH
3#ifndef SCM_PORTS_H
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
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
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 */
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
35
6c951427 36#define SCM_INITIAL_PUTBACK_BUF_SIZE 4
0855ef71 37
61e452ba 38/* values for the rw_active flag. */
92c2555f 39typedef 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
47typedef 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. */
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. */
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
112SCM_API scm_t_port **scm_i_port_table;
113SCM_API long scm_i_port_table_size; /* Number of ports in scm_i_port_table. */
b9ad392e 114SCM_API scm_t_mutex 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
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) \
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
159#define SCM_INCLINE(port) {SCM_LINUM (port) += 1; SCM_COL (port) = 0;}
160#define SCM_INCCOL(port) {SCM_COL (port) += 1;}
d14af9f2 161#define SCM_TABCOL(port) {SCM_COL (port) += 8 - SCM_COL (port) % 8;}
0f2d19dd 162
0f2d19dd
JB
163\f
164
affc96b5 165/* port-type description. */
92c2555f 166typedef struct scm_t_ptob_descriptor
0f82baf6 167{
f12733c9 168 char *name;
0c0669cc 169 SCM (*mark) (SCM);
1be6b49c 170 size_t (*free) (SCM);
0c0669cc
JB
171 int (*print) (SCM exp, SCM port, scm_print_state *pstate);
172 SCM (*equalp) (SCM, SCM);
affc96b5
GH
173 int (*close) (SCM port);
174
8aa011a1 175 void (*write) (SCM port, const void *data, size_t size);
affc96b5
GH
176 void (*flush) (SCM port);
177
178 void (*end_input) (SCM port, int offset);
179 int (*fill_input) (SCM port);
180 int (*input_waiting) (SCM port);
181
ee149d03 182 off_t (*seek) (SCM port, off_t OFFSET, int WHENCE);
affc96b5
GH
183 void (*truncate) (SCM port, off_t length);
184
92c2555f 185} scm_t_ptob_descriptor;
1be6b49c 186
12a8b769
DH
187#define SCM_TC2PTOBNUM(x) (0x0ff & ((x) >> 8))
188#define SCM_PTOBNUM(x) (SCM_TC2PTOBNUM (SCM_CELL_TYPE (x)))
f12733c9
MD
189/* SCM_PTOBNAME can be 0 if name is missing */
190#define SCM_PTOBNAME(ptobnum) scm_ptobs[ptobnum].name
0f82baf6
JB
191
192\f
193
33b001fd
MV
194SCM_API scm_t_ptob_descriptor *scm_ptobs;
195SCM_API long scm_numptob;
67329a9e 196SCM_API long scm_i_port_table_room;
0f2d19dd
JB
197
198\f
0f2d19dd 199
33b001fd
MV
200SCM_API SCM scm_markstream (SCM ptr);
201SCM_API scm_t_bits scm_make_port_type (char *name,
202 int (*fill_input) (SCM port),
203 void (*write) (SCM port,
204 const void *data,
205 size_t size));
206SCM_API void scm_set_port_mark (long tc, SCM (*mark) (SCM));
207SCM_API void scm_set_port_free (long tc, size_t (*free) (SCM));
208SCM_API void scm_set_port_print (long tc,
209 int (*print) (SCM exp,
210 SCM port,
211 scm_print_state *pstate));
212SCM_API void scm_set_port_equalp (long tc, SCM (*equalp) (SCM, SCM));
213SCM_API void scm_set_port_close (long tc, int (*close) (SCM));
214
215SCM_API void scm_set_port_flush (long tc,
216 void (*flush) (SCM port));
217SCM_API void scm_set_port_end_input (long tc,
218 void (*end_input) (SCM port,
219 int offset));
220SCM_API void scm_set_port_seek (long tc,
221 off_t (*seek) (SCM port,
222 off_t OFFSET,
223 int WHENCE));
224SCM_API void scm_set_port_truncate (long tc,
225 void (*truncate) (SCM port,
226 off_t length));
227SCM_API void scm_set_port_input_waiting (long tc, int (*input_waiting) (SCM));
228SCM_API SCM scm_char_ready_p (SCM port);
c2da2648 229size_t scm_take_from_input_buffers (SCM port, char *dest, size_t read_len);
33b001fd
MV
230SCM_API SCM scm_drain_input (SCM port);
231SCM_API SCM scm_current_input_port (void);
232SCM_API SCM scm_current_output_port (void);
233SCM_API SCM scm_current_error_port (void);
234SCM_API SCM scm_current_load_port (void);
235SCM_API SCM scm_set_current_input_port (SCM port);
236SCM_API SCM scm_set_current_output_port (SCM port);
237SCM_API SCM scm_set_current_error_port (SCM port);
07add345
MV
238SCM_API void scm_frame_current_input_port (SCM port);
239SCM_API void scm_frame_current_output_port (SCM port);
240SCM_API void scm_frame_current_error_port (SCM port);
da220f27 241SCM_API SCM scm_new_port_table_entry (scm_t_bits tag);
33b001fd
MV
242SCM_API void scm_remove_from_port_table (SCM port);
243SCM_API void scm_grow_port_cbuf (SCM port, size_t requested);
244SCM_API SCM scm_pt_size (void);
245SCM_API SCM scm_pt_member (SCM member);
246SCM_API void scm_port_non_buffer (scm_t_port *pt);
247SCM_API int scm_revealed_count (SCM port);
248SCM_API SCM scm_port_revealed (SCM port);
249SCM_API SCM scm_set_port_revealed_x (SCM port, SCM rcount);
250SCM_API long scm_mode_bits (char *modes);
251SCM_API SCM scm_port_mode (SCM port);
252SCM_API SCM scm_close_input_port (SCM port);
253SCM_API SCM scm_close_output_port (SCM port);
254SCM_API SCM scm_close_port (SCM port);
255SCM_API SCM scm_port_for_each (SCM proc);
c536b4b3 256SCM_API void scm_c_port_for_each (void (*proc)(void *data, SCM p), void *data);
33b001fd
MV
257SCM_API SCM scm_input_port_p (SCM x);
258SCM_API SCM scm_output_port_p (SCM x);
259SCM_API SCM scm_port_p (SCM x);
260SCM_API SCM scm_port_closed_p (SCM port);
261SCM_API SCM scm_eof_object_p (SCM x);
262SCM_API SCM scm_force_output (SCM port);
263SCM_API SCM scm_flush_all_ports (void);
264SCM_API SCM scm_read_char (SCM port);
265SCM_API void scm_putc (char c, SCM port);
266SCM_API void scm_puts (const char *str_data, SCM port);
267SCM_API size_t scm_c_read (SCM port, void *buffer, size_t size);
268SCM_API void scm_c_write (SCM port, const void *buffer, size_t size);
269SCM_API void scm_lfwrite (const char *ptr, size_t size, SCM port);
270SCM_API void scm_flush (SCM port);
271SCM_API void scm_end_input (SCM port);
272SCM_API int scm_fill_input (SCM port);
273SCM_API int scm_getc (SCM port);
274SCM_API void scm_ungetc (int c, SCM port);
275SCM_API void scm_ungets (const char *s, int n, SCM port);
276SCM_API SCM scm_peek_char (SCM port);
277SCM_API SCM scm_unread_char (SCM cobj, SCM port);
278SCM_API SCM scm_unread_string (SCM str, SCM port);
279SCM_API SCM scm_seek (SCM object, SCM offset, SCM whence);
280SCM_API SCM scm_truncate_file (SCM object, SCM length);
281SCM_API SCM scm_port_line (SCM port);
282SCM_API SCM scm_set_port_line_x (SCM port, SCM line);
283SCM_API SCM scm_port_column (SCM port);
284SCM_API SCM scm_set_port_column_x (SCM port, SCM line);
285SCM_API SCM scm_port_filename (SCM port);
286SCM_API SCM scm_set_port_filename_x (SCM port, SCM filename);
287SCM_API int scm_port_print (SCM exp, SCM port, scm_print_state *);
288SCM_API void scm_print_port_mode (SCM exp, SCM port);
289SCM_API void scm_ports_prehistory (void);
290SCM_API SCM scm_void_port (char * mode_str);
291SCM_API SCM scm_sys_make_void_port (SCM mode);
292SCM_API void scm_init_ports (void);
0f2d19dd 293
67329a9e
HWN
294
295#if SCM_ENABLE_DEPRECATED==1
296SCM_API scm_t_port * scm_add_to_port_table (SCM port);
297#endif
298
f3667f52 299#ifdef GUILE_DEBUG
33b001fd
MV
300SCM_API SCM scm_pt_size (void);
301SCM_API SCM scm_pt_member (SCM member);
be1cd096 302#endif /* GUILE_DEBUG */
f3667f52 303
22a52da1 304#endif /* SCM_PORTS_H */
89e00824
ML
305
306/*
307 Local Variables:
308 c-file-style: "gnu"
309 End:
310*/