From: Kevin Ryde <user42@zip.com.au>
Date: Sat, 13 Sep 2003 00:09:14 +0000 (+0000)
Subject: (Reading): Add scm_c_read.
X-Git-Url: http://git.hcoop.net/bpt/guile.git/commitdiff_plain/eee36f210501b8492049815556c40153ba1e35da

(Reading): Add scm_c_read.
(Writing): Add scm_c_write.
---

diff --git a/doc/ref/scheme-io.texi b/doc/ref/scheme-io.texi
index 729bad755..3dc1dd4aa 100644
--- a/doc/ref/scheme-io.texi
+++ b/doc/ref/scheme-io.texi
@@ -120,6 +120,15 @@ Return the next character available from @var{port}, updating
 characters are available, the end-of-file object is returned.
 @end deffn
 
+@deftypefn {C Function} size_t scm_c_read (SCM port, void *buffer, size_t size)
+Read up to @var{size} bytes from @var{port} and store them in
+@var{buffer}.  The return value is the number of bytes actually read,
+which can be less than @var{size} if end-of-file has been reached.
+
+Note that this function does not update @code{port-line} and
+@code{port-column} below.
+@end deftypefn
+
 @rnindex peek-char
 @deffn {Scheme Procedure} peek-char [port]
 @deffnx {C Function} scm_peek_char (port)
@@ -268,6 +277,13 @@ containing the formatted text. Does not add a trailing newline.
 Send character @var{chr} to @var{port}.
 @end deffn
 
+@deftypefn {C Function} void scm_c_write (SCM port, const void *buffer, size_t size)
+Write @var{size} bytes at @var{buffer} to @var{port}.
+
+Note that this function does not update @code{port-line} and
+@code{port-column} (@pxref{Reading}).
+@end deftypefn
+
 @findex fflush
 @deffn {Scheme Procedure} force-output [port]
 @deffnx {C Function} scm_force_output (port)