(Reading): Add scm_c_read.
authorKevin Ryde <user42@zip.com.au>
Sat, 13 Sep 2003 00:09:14 +0000 (00:09 +0000)
committerKevin Ryde <user42@zip.com.au>
Sat, 13 Sep 2003 00:09:14 +0000 (00:09 +0000)
(Writing): Add scm_c_write.

doc/ref/scheme-io.texi

index 729bad7..3dc1dd4 100644 (file)
@@ -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)