guile/guile-core NEWS

[Gary Houston]

CVSROOT:        /cvs
Module name:    guile
Changes by:     Gary Houston <address@hidden>   01/01/06 14:04:04

Modified files:
        guile-core     : NEWS 

Log message:
        

CVSWeb URLs:
http://subversions.gnu.org/cgi-bin/cvsweb/guile/guile-core/NEWS.diff?r1=1.238&r2=1.239

Patches:
Index: guile/guile-core/NEWS
diff -u guile/guile-core/NEWS:1.238 guile/guile-core/NEWS:1.239
--- guile/guile-core/NEWS:1.238 Fri Jan  5 01:29:12 2001
+++ guile/guile-core/NEWS       Sat Jan  6 14:04:04 2001
@@ -217,6 +217,33 @@
 
 Instead, use scm_c_memq or scm_memq, scm_memv, scm_member.
 
+** New function: read-string!/partial str [port_or_fdes [start [end]]]
+
+     Read characters from an fport or file descriptor into a string
+     STR.  This procedure is scsh-compatible and can efficiently read
+     large strings.  It will:
+
+        * attempt to fill the entire string, unless the START and/or
+          END arguments are supplied.  i.e., START defaults to 0 and
+          END defaults to `(string-length str)'
+
+        * use the current input port if PORT_OR_FDES is not supplied.
+
+        * read any characters that are currently available, without
+          waiting for the rest (short reads are possible).
+
+        * wait for as long as it needs to for the first character to
+          become available, unless the port is in non-blocking mode
+
+        * return `#f' if end-of-file is encountered before reading any
+          characters, otherwise return the number of characters read.
+
+        * return 0 if the port is in non-blocking mode and no characters
+          are immediately available.
+
+        * return 0 if the request is for 0 bytes, with no end-of-file
+          check
+
 ** New function: port? X
 
 Returns a boolean indicating whether X is a port.  Equivalent to
@@ -233,7 +260,7 @@
 descriptor OLDFD to descriptor number NEWFD, replacing the
 previous meaning of NEWFD.  Both OLDFD and NEWFD must be integers.
 Unlike for dup->fdes or primitive-move->fdes, no attempt is made
-to move away ports which are using NEWFD\n".  The return value is
+to move away ports which are using NEWFD.  The return value is
 unspecified.
 
 ** New function: close-fdes fd