mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-05-02 04:40:29 +02:00
Code Activity

(File Ports): In open-file, describe the "b" binary flag.

Browse source
This commit is contained in:
Kevin Ryde 2004-08-09 01:32:22 +00:00
parent abc358f9c5
commit c755b8615e
1 changed files with 15 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

15
doc/ref/api-io.texi
View file

@ -684,6 +684,7 @@ representing that file. The attributes of the port are
determined by the @var{mode} string. The way in which this is determined by the @var{mode} string. The way in which this is
interpreted is similar to C stdio. The first character must be interpreted is similar to C stdio. The first character must be
one of the following: one of the following:
@table @samp @table @samp
@item r @item r
Open an existing file for input. Open an existing file for input.
@ -696,7 +697,9 @@ exist. All writes to the port will go to the end of the file.
The "append mode" can be turned off while the port is in use The "append mode" can be turned off while the port is in use
@pxref{Ports and File Descriptors, fcntl} @pxref{Ports and File Descriptors, fcntl}
@end table @end table
The following additional characters can be appended: The following additional characters can be appended:
@table @samp @table @samp
@item + @item +
Open the port for both input and output. E.g., @code{r+}: open Open the port for both input and output. E.g., @code{r+}: open
@ -711,7 +714,19 @@ setvbuf}
@item l @item l
Add line-buffering to the port. The port output buffer will be Add line-buffering to the port. The port output buffer will be
automatically flushed whenever a newline character is written. automatically flushed whenever a newline character is written.
@item b
Use binary mode. On DOS systems the default text mode converts CR+LF
in the file to newline for the program, whereas binary mode reads and
writes all bytes unchanged. On Unix-like systems there is no such
distinction, text files already contain just newlines and no
conversion is ever made. The @code{b} flag is accepted on all
systems, but has no effect on Unix-like systems.
(For reference, Guile leaves text versus binary up to the C library,
@code{b} here just adds @code{O_BINARY} to the underlying @code{open}
call, when that flag is available.)
@end table @end table
In theory we could create read/write ports which were buffered In theory we could create read/write ports which were buffered
in one direction only. However this isn't included in the in one direction only. However this isn't included in the
current interfaces. If a file cannot be opened with the access current interfaces. If a file cannot be opened with the access