* 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. */
+
+/* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
+ gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
+
\f
#include "fports.h"
#include "unif.h"
#include "chars.h"
+#include "feature.h"
+#include "validate.h"
#include "ioext.h"
#include <fcntl.h>
#endif
\f
-SCM_PROC (s_read_delimited_x, "%read-delimited!", 3, 3, 0, scm_read_delimited_x);
-
-SCM
-scm_read_delimited_x (delims, buf, gobble, port, start, end)
- SCM delims;
- SCM buf;
- SCM gobble;
- SCM port;
- SCM start;
- SCM end;
+SCM_DEFINE (scm_read_delimited_x, "%read-delimited!", 3, 3, 0,
+ (SCM delims, SCM buf, SCM gobble, SCM port, SCM start, SCM end),
+ "Read characters from @var{port} into @var{buf} until one of the\n"
+ "characters in the @var{delims} string is encountered. If @var{gobble?}\n"
+ "is true, store the delimiter character in @var{buf} as well; otherwise,\n"
+ "discard it. If @var{port} is not specified, use the value of\n"
+ "@code{(current-input-port)}. If @var{start} or @var{end} are specified,\n"
+ "store data only into the substring of @var{buf} bounded by @var{start}\n"
+ "and @var{end} (which default to the beginning and end of the buffer,\n"
+ "respectively).\n\n"
+ "Return a pair consisting of the delimiter that terminated the string and\n"
+ "the number of characters read. If reading stopped at the end of file,\n"
+ "the delimiter returned is the @var{eof-object}; if the buffer was filled\n"
+ "without encountering a delimiter, this value is @var{#f}.")
+#define FUNC_NAME s_scm_read_delimited_x
{
long j;
char *cbuf;
long cstart;
- long cend;
+ long cend, tend;
int c;
char *cdelims;
int num_delims;
- SCM_ASSERT (SCM_NIMP (delims) && SCM_ROSTRINGP (delims),
- delims, SCM_ARG1, s_read_delimited_x);
- cdelims = SCM_ROCHARS (delims);
+ SCM_VALIDATE_ROSTRING_COPY (1,delims,cdelims);
num_delims = SCM_ROLENGTH (delims);
- SCM_ASSERT (SCM_NIMP (buf) && SCM_STRINGP (buf),
- buf, SCM_ARG2, s_read_delimited_x);
- cbuf = SCM_CHARS (buf);
+ SCM_VALIDATE_STRING_COPY (2,buf,cbuf);
cend = SCM_LENGTH (buf);
if (SCM_UNBNDP (port))
port = scm_cur_inp;
else
- {
- SCM_ASSERT (SCM_NIMP (port) && SCM_OPINPORTP (port),
- port, SCM_ARG1, s_read_delimited_x);
- }
+ SCM_VALIDATE_OPINPORT (4,port);
- if (SCM_UNBNDP (start))
- cstart = 0;
- else
- {
- cstart = scm_num2long (start,
- (char *) SCM_ARG5, s_read_delimited_x);
- if (cstart < 0 || cstart >= cend)
- scm_out_of_range (s_read_delimited_x, start);
+ SCM_VALIDATE_INUM_DEF_COPY (5,start,0,cstart);
+ SCM_ASSERT_RANGE(5, start, cstart >= 0 && cstart < cend);
- if (!SCM_UNBNDP (end))
- {
- long tend = scm_num2long (end, (char *) SCM_ARG6,
- s_read_delimited_x);
- if (tend <= cstart || tend > cend)
- scm_out_of_range (s_read_delimited_x, end);
- cend = tend;
- }
- }
+ SCM_VALIDATE_INUM_DEF_COPY (6,end,cend,tend);
+ SCM_ASSERT_RANGE(6, end, tend > cstart && tend <= cend);
+
+ cend = tend;
for (j = cstart; j < cend; j++)
{
if (SCM_FALSEP (gobble))
scm_ungetc (c, port);
- return scm_cons (SCM_MAKICHR (c),
+ return scm_cons (SCM_MAKE_CHAR (c),
scm_long2num (j - cstart));
}
}
}
return scm_cons (SCM_BOOL_F, scm_long2num (j - cstart));
}
+#undef FUNC_NAME
static unsigned char *
scm_do_read_line (SCM port, int *len_p)
{
int buf_len = (end + 1) - pt->read_pos;
/* Allocate a buffer of the perfect size. */
- unsigned char *buf = malloc (buf_len + 1);
+ unsigned char *buf = scm_must_malloc (buf_len + 1, "%read-line");
memcpy (buf, pt->read_pos, buf_len);
pt->read_pos += buf_len;
int buf_size = (len < 50) ? 60 : len * 2;
/* Invariant: buf always has buf_size + 1 characters allocated;
the `+ 1' is for the final '\0'. */
- unsigned char *buf = malloc (buf_size + 1);
+ unsigned char *buf = scm_must_malloc (buf_size + 1, "%read-line");
int buf_len = 0;
- int c;
for (;;)
{
if (buf_len + len > buf_size)
{
int new_size = (buf_len + len) * 2;
- buf = realloc (buf, new_size + 1);
+ buf = scm_must_realloc (buf, buf_size + 1, new_size + 1,
+ "%read-line");
buf_size = new_size;
}
if (end)
break;
- /* Get more characters. I think having fill_buffer return a
- character is not terribly graceful... */
- c = scm_fill_buffer (port, pt);
- if (c == EOF)
+ /* Get more characters. */
+ if (scm_fill_input (port) == EOF)
{
/* If we're missing a final newline in the file, return
what we did get, sans newline. */
return 0;
}
- /* ... because it makes us duplicate code here... */
- if (buf_len + 1 > buf_size)
- {
- int new_size = buf_size * 2;
- buf = realloc (buf, new_size + 1);
- buf_size = new_size;
- }
-
- /* ... and this is really a duplication of the memcpy and
- memchr calls, on a single-byte buffer. */
- buf[buf_len++] = c;
- if (c == '\n')
- break;
-
/* Search the buffer for newlines. */
if ((end = memchr (pt->read_pos, '\n',
(len = (pt->read_end - pt->read_pos))))
}
/* I wonder how expensive this realloc is. */
- buf = realloc (buf, buf_len + 1);
+ buf = scm_must_realloc (buf, buf_size + 1, buf_len + 1, "%read-line");
buf[buf_len] = '\0';
*len_p = buf_len;
return buf;
* efficiently in Scheme.
*/
-SCM_PROC (s_read_line, "%read-line", 0, 1, 0, scm_read_line);
-
-SCM
-scm_read_line (port)
- SCM port;
+SCM_DEFINE (scm_read_line, "%read-line", 0, 1, 0,
+ (SCM port),
+ "Read a newline-terminated line from @var{port}, allocating storage as\n"
+ "necessary. The newline terminator (if any) is removed from the string,\n"
+ "and a pair consisting of the line and its delimiter is returned. The\n"
+ "delimiter may be either a newline or the @var{eof-object}; if\n"
+ "@code{%read-line} is called at the end of file, it returns the pair\n"
+ "@code{(#<eof> . #<eof>)}.")
+#define FUNC_NAME s_scm_read_line
{
scm_port *pt;
char *s;
if (SCM_UNBNDP (port))
port = scm_cur_inp;
- else
- {
- SCM_ASSERT (SCM_NIMP (port) && SCM_OPINPORTP (port),
- port, SCM_ARG1, s_read_line);
- }
+ SCM_VALIDATE_OPINPORT (1,port);
pt = SCM_PTAB_ENTRY (port);
if (pt->rw_active == SCM_PORT_WRITE)
- scm_ptobs[SCM_PTOBNUM (port)].fflush (port);
+ scm_ptobs[SCM_PTOBNUM (port)].flush (port);
s = scm_do_read_line (port, &slen);
{
if (s[slen-1] == '\n')
{
- term = SCM_MAKICHR ('\n');
+ term = SCM_MAKE_CHAR ('\n');
s[slen-1] = '\0';
line = scm_take_str (s, slen-1);
+ scm_done_malloc (-1);
SCM_INCLINE (port);
}
else
return scm_cons (line, term);
}
-
-SCM_PROC (s_write_line, "write-line", 1, 1, 0, scm_write_line);
-
-SCM
-scm_write_line (obj, port)
- SCM obj;
- SCM port;
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_write_line, "write-line", 1, 1, 0,
+ (SCM obj, SCM port),
+ "Display @var{obj} and a newline character to @var{port}. If @var{port}\n"
+ "is not specified, @code{(current-output-port)} is used. This function\n"
+ "is equivalent to:\n\n"
+ "@smalllisp\n"
+ "(display obj [port])\n"
+ "(newline [port])\n"
+ "@end smalllisp")
+#define FUNC_NAME s_scm_write_line
{
scm_display (obj, port);
return scm_newline (port);
}
-
-SCM_PROC (s_ftell, "ftell", 1, 0, 0, scm_ftell);
-
-SCM
-scm_ftell (object)
- SCM object;
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_ftell, "ftell", 1, 0, 0,
+ (SCM object),
+ "Returns an integer representing the current position of @var{fd/port},\n"
+ "measured from the beginning. Equivalent to:\n"
+ "@smalllisp\n"
+ "(seek port 0 SEEK_CUR)\n"
+ "@end smalllisp")
+#define FUNC_NAME s_scm_ftell
{
- return scm_lseek (object, SCM_INUM0, SCM_MAKINUM (SEEK_CUR));
+ return scm_seek (object, SCM_INUM0, SCM_MAKINUM (SEEK_CUR));
}
+#undef FUNC_NAME
-SCM_PROC (s_fseek, "fseek", 3, 0, 0, scm_fseek);
-
-SCM
-scm_fseek (object, offset, whence)
- SCM object;
- SCM offset;
- SCM whence;
+SCM_DEFINE (scm_fseek, "fseek", 3, 0, 0,
+ (SCM object, SCM offset, SCM whence),
+ "Obsolete. Almost the same as seek, above, but the return value is\n"
+ "unspecified.")
+#define FUNC_NAME s_scm_fseek
{
- scm_lseek (object, offset, whence);
-
+ scm_seek (object, offset, whence);
return SCM_UNSPECIFIED;
}
-
-SCM_PROC (s_redirect_port, "redirect-port", 2, 0, 0, scm_redirect_port);
-
-SCM
-scm_redirect_port (old, new)
- SCM old;
- SCM new;
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_redirect_port, "redirect-port", 2, 0, 0,
+ (SCM old, SCM new),
+ "This procedure takes two ports and duplicates the underlying file\n"
+ "descriptor from @var{old-port} into @var{new-port}. The\n"
+ "current file descriptor in @var{new-port} will be closed.\n"
+ "After the redirection the two ports will share a file position\n"
+ "and file status flags.\n\n"
+ "The return value is unspecified.\n\n"
+ "Unexpected behaviour can result if both ports are subsequently used\n"
+ "and the original and/or duplicate ports are buffered.\n\n"
+ "This procedure does not have any side effects on other ports or\n"
+ "revealed counts.")
+#define FUNC_NAME s_scm_redirect_port
{
int ans, oldfd, newfd;
struct scm_fport *fp;
old = SCM_COERCE_OUTPORT (old);
new = SCM_COERCE_OUTPORT (new);
-
- SCM_ASSERT (SCM_NIMP (old) && SCM_OPFPORTP (old), old, SCM_ARG1, s_redirect_port);
- SCM_ASSERT (SCM_NIMP (new) && SCM_OPFPORTP (new), new, SCM_ARG2, s_redirect_port);
+
+ SCM_VALIDATE_OPFPORT (1,old);
+ SCM_VALIDATE_OPFPORT (2,new);
oldfd = SCM_FPORT_FDES (old);
fp = SCM_FSTREAM (new);
newfd = fp->fdes;
{
scm_port *pt = SCM_PTAB_ENTRY (new);
scm_port *old_pt = SCM_PTAB_ENTRY (old);
- scm_ptobfuns *ptob = &scm_ptobs[SCM_PTOBNUM (new)];
+ scm_ptob_descriptor *ptob = &scm_ptobs[SCM_PTOBNUM (new)];
/* must flush to old fdes. */
if (pt->rw_active == SCM_PORT_WRITE)
- ptob->fflush (new);
+ ptob->flush (new);
else if (pt->rw_active == SCM_PORT_READ)
- ptob->read_flush (new);
+ scm_end_input (new);
ans = dup2 (oldfd, newfd);
if (ans == -1)
- scm_syserror (s_redirect_port);
+ SCM_SYSERROR;
pt->rw_random = old_pt->rw_random;
/* continue using existing buffers, even if inappropriate. */
}
return SCM_UNSPECIFIED;
}
+#undef FUNC_NAME
-SCM_PROC (s_dup_to_fdes, "dup->fdes", 1, 1, 0, scm_dup_to_fdes);
-SCM
-scm_dup_to_fdes (SCM fd_or_port, SCM fd)
+SCM_DEFINE (scm_dup_to_fdes, "dup->fdes", 1, 1, 0,
+ (SCM fd_or_port, SCM fd),
+ "Returns an integer file descriptor.")
+#define FUNC_NAME s_scm_dup_to_fdes
{
int oldfd, newfd, rv;
oldfd = SCM_INUM (fd_or_port);
else
{
- SCM_ASSERT (SCM_NIMP (fd_or_port) && SCM_OPFPORTP (fd_or_port),
- fd_or_port, SCM_ARG1, s_dup_to_fdes);
+ SCM_VALIDATE_OPFPORT (1,fd_or_port);
oldfd = SCM_FPORT_FDES (fd_or_port);
}
{
newfd = dup (oldfd);
if (newfd == -1)
- scm_syserror (s_dup_to_fdes);
+ SCM_SYSERROR;
fd = SCM_MAKINUM (newfd);
}
else
{
- SCM_ASSERT (SCM_INUMP (fd), fd, SCM_ARG2, s_dup_to_fdes);
- newfd = SCM_INUM (fd);
+ SCM_VALIDATE_INUM_COPY (2, fd, newfd);
if (oldfd != newfd)
{
scm_evict_ports (newfd); /* see scsh manual. */
rv = dup2 (oldfd, newfd);
if (rv == -1)
- scm_syserror (s_dup_to_fdes);
+ SCM_SYSERROR;
}
}
return fd;
}
+#undef FUNC_NAME
-SCM_PROC (s_fileno, "fileno", 1, 0, 0, scm_fileno);
-
-SCM
-scm_fileno (port)
- SCM port;
+SCM_DEFINE (scm_fileno, "fileno", 1, 0, 0,
+ (SCM port),
+ "Returns the integer file descriptor underlying @var{port}.\n"
+ "Does not change its revealed count.")
+#define FUNC_NAME s_scm_fileno
{
port = SCM_COERCE_OUTPORT (port);
- SCM_ASSERT (SCM_NIMP (port) && SCM_OPFPORTP (port), port, SCM_ARG1,
- s_fileno);
+ SCM_VALIDATE_OPFPORT (1,port);
return SCM_MAKINUM (SCM_FPORT_FDES (port));
}
-
-SCM_PROC (s_isatty, "isatty?", 1, 0, 0, scm_isatty_p);
-
-SCM
-scm_isatty_p (port)
- SCM port;
+#undef FUNC_NAME
+
+/* GJB:FIXME:: why does this not throw
+ an error if the arg is not a port?
+ This proc as is would be better names isattyport?
+ if it is not going to assume that the arg is a port */
+SCM_DEFINE (scm_isatty_p, "isatty?", 1, 0, 0,
+ (SCM port),
+ "Returns @code{#t} if @var{port} is using a serial\n"
+ "non-file device, otherwise @code{#f}.")
+#define FUNC_NAME s_scm_isatty_p
{
int rv;
port = SCM_COERCE_OUTPORT (port);
- if (!(SCM_NIMP (port) && SCM_OPFPORTP (port)))
+ if (!SCM_OPFPORTP (port))
return SCM_BOOL_F;
rv = isatty (SCM_FPORT_FDES (port));
- return rv ? SCM_BOOL_T : SCM_BOOL_F;
+ return SCM_BOOL(rv);
}
+#undef FUNC_NAME
-SCM_PROC (s_fdopen, "fdopen", 2, 0, 0, scm_fdopen);
-
-SCM
-scm_fdopen (fdes, modes)
- SCM fdes;
- SCM modes;
+SCM_DEFINE (scm_fdopen, "fdopen", 2, 0, 0,
+ (SCM fdes, SCM modes),
+ "Returns a new port based on the file descriptor @var{fdes}.\n"
+ "Modes are given by the string @var{modes}. The revealed count of the port\n"
+ "is initialized to zero. The modes string is the same as that accepted\n"
+ "by @ref{File Ports, open-file}.")
+#define FUNC_NAME s_scm_fdopen
{
- SCM port;
-
- SCM_ASSERT (SCM_INUMP (fdes), fdes, SCM_ARG1, s_fdopen);
- SCM_ASSERT (SCM_NIMP (modes) && SCM_ROSTRINGP (modes), modes, SCM_ARG2,
- s_fdopen);
+ SCM_VALIDATE_INUM (1,fdes);
+ SCM_VALIDATE_ROSTRING (2,modes);
SCM_COERCE_SUBSTR (modes);
- port = scm_fdes_to_port (SCM_INUM (fdes), SCM_ROCHARS (modes), SCM_BOOL_F);
- return port;
+
+ return scm_fdes_to_port (SCM_INUM (fdes), SCM_ROCHARS (modes), SCM_BOOL_F);
}
+#undef FUNC_NAME
* #t if fdes moved.
* MOVE->FDES is implemented in Scheme and calls this primitive.
*/
-SCM_PROC (s_primitive_move_to_fdes, "primitive-move->fdes", 2, 0, 0, scm_primitive_move_to_fdes);
-
-SCM
-scm_primitive_move_to_fdes (port, fd)
- SCM port;
- SCM fd;
+SCM_DEFINE (scm_primitive_move_to_fdes, "primitive-move->fdes", 2, 0, 0,
+ (SCM port, SCM fd),
+ "Moves the underlying file descriptor for @var{port} to the integer\n"
+ "value @var{fdes} without changing the revealed count of @var{port}.\n"
+ "Any other ports already using this descriptor will be automatically\n"
+ "shifted to new descriptors and their revealed counts reset to zero.\n"
+ "The return value is @code{#f} if the file descriptor already had the\n"
+ "required value or @code{#t} if it was moved.")
+#define FUNC_NAME s_scm_primitive_move_to_fdes
{
struct scm_fport *stream;
int old_fd;
port = SCM_COERCE_OUTPORT (port);
- SCM_ASSERT (SCM_NIMP (port) && SCM_OPFPORTP (port), port, SCM_ARG1, s_primitive_move_to_fdes);
- SCM_ASSERT (SCM_INUMP (fd), fd, SCM_ARG2, s_primitive_move_to_fdes);
+ SCM_VALIDATE_OPFPORT (1,port);
+ SCM_VALIDATE_INUM (2,fd);
stream = SCM_FSTREAM (port);
old_fd = stream->fdes;
new_fd = SCM_INUM (fd);
scm_evict_ports (new_fd);
rv = dup2 (old_fd, new_fd);
if (rv == -1)
- scm_syserror (s_primitive_move_to_fdes);
+ SCM_SYSERROR;
stream->fdes = new_fd;
SCM_SYSCALL (close (old_fd));
return SCM_BOOL_T;
}
+#undef FUNC_NAME
/* Return a list of ports using a given file descriptor. */
-SCM_PROC(s_fdes_to_ports, "fdes->ports", 1, 0, 0, scm_fdes_to_ports);
-
-SCM
-scm_fdes_to_ports (fd)
- SCM fd;
+SCM_DEFINE (scm_fdes_to_ports, "fdes->ports", 1, 0, 0,
+ (SCM fd),
+ "Returns a list of existing ports which have @var{fdes} as an\n"
+ "underlying file descriptor, without changing their revealed counts.")
+#define FUNC_NAME s_scm_fdes_to_ports
{
SCM result = SCM_EOL;
int int_fd;
int i;
- SCM_ASSERT (SCM_INUMP (fd), fd, SCM_ARG1, s_fdes_to_ports);
- int_fd = SCM_INUM (fd);
+ SCM_VALIDATE_INUM_COPY (1,fd,int_fd);
for (i = 0; i < scm_port_table_size; i++)
{
result = scm_cons (scm_port_table[i]->port, result);
}
return result;
-}
+}
+#undef FUNC_NAME
void
scm_init_ioext ()
{
+ scm_add_feature ("i/o-extensions");
+
#include "ioext.x"
}