mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-06-21 03:00:19 +02:00
Add various @cindex entries.
This commit is contained in:
parent
1469729406
commit
364f8ccfdc
1 changed files with 27 additions and 0 deletions
|
@ -24,6 +24,7 @@
|
||||||
|
|
||||||
@node Ports
|
@node Ports
|
||||||
@subsection Ports
|
@subsection Ports
|
||||||
|
@cindex Port
|
||||||
|
|
||||||
Sequential input/output in Scheme is represented by operations on a
|
Sequential input/output in Scheme is represented by operations on a
|
||||||
@dfn{port}. This chapter explains the operations that Guile provides
|
@dfn{port}. This chapter explains the operations that Guile provides
|
||||||
|
@ -94,10 +95,12 @@ Equivalent to @code{(or (input-port? @var{x}) (output-port?
|
||||||
|
|
||||||
@node Reading
|
@node Reading
|
||||||
@subsection Reading
|
@subsection Reading
|
||||||
|
@cindex Reading
|
||||||
|
|
||||||
[Generic procedures for reading from ports.]
|
[Generic procedures for reading from ports.]
|
||||||
|
|
||||||
@rnindex eof-object?
|
@rnindex eof-object?
|
||||||
|
@cindex End of file object
|
||||||
@deffn {Scheme Procedure} eof-object? x
|
@deffn {Scheme Procedure} eof-object? x
|
||||||
@deffnx {C Function} scm_eof_object_p (x)
|
@deffnx {C Function} scm_eof_object_p (x)
|
||||||
Return @code{#t} if @var{x} is an end-of-file object; otherwise
|
Return @code{#t} if @var{x} is an end-of-file object; otherwise
|
||||||
|
@ -217,6 +220,7 @@ Set the current column or line number of @var{port}.
|
||||||
|
|
||||||
@node Writing
|
@node Writing
|
||||||
@subsection Writing
|
@subsection Writing
|
||||||
|
@cindex Writing
|
||||||
|
|
||||||
[Generic procedures for writing to ports.]
|
[Generic procedures for writing to ports.]
|
||||||
|
|
||||||
|
@ -320,6 +324,8 @@ all open output ports. The return value is unspecified.
|
||||||
|
|
||||||
@node Closing
|
@node Closing
|
||||||
@subsection Closing
|
@subsection Closing
|
||||||
|
@cindex Closing ports
|
||||||
|
@cindex Port, close
|
||||||
|
|
||||||
@deffn {Scheme Procedure} close-port port
|
@deffn {Scheme Procedure} close-port port
|
||||||
@deffnx {C Function} scm_close_port (port)
|
@deffnx {C Function} scm_close_port (port)
|
||||||
|
@ -354,6 +360,8 @@ open.
|
||||||
|
|
||||||
@node Random Access
|
@node Random Access
|
||||||
@subsection Random Access
|
@subsection Random Access
|
||||||
|
@cindex Random access, ports
|
||||||
|
@cindex Port, random access
|
||||||
|
|
||||||
@deffn {Scheme Procedure} seek fd_port offset whence
|
@deffn {Scheme Procedure} seek fd_port offset whence
|
||||||
@deffnx {C Function} scm_seek (fd_port, offset, whence)
|
@deffnx {C Function} scm_seek (fd_port, offset, whence)
|
||||||
|
@ -410,6 +418,8 @@ the current size, but this is not mandatory in the POSIX standard.
|
||||||
|
|
||||||
@node Line/Delimited
|
@node Line/Delimited
|
||||||
@subsection Line Oriented and Delimited Text
|
@subsection Line Oriented and Delimited Text
|
||||||
|
@cindex Line input/output
|
||||||
|
@cindex Port, line input/output
|
||||||
|
|
||||||
The delimited-I/O module can be accessed with:
|
The delimited-I/O module can be accessed with:
|
||||||
|
|
||||||
|
@ -520,6 +530,8 @@ delimiter may be either a newline or the @var{eof-object}; if
|
||||||
|
|
||||||
@node Block Reading and Writing
|
@node Block Reading and Writing
|
||||||
@subsection Block reading and writing
|
@subsection Block reading and writing
|
||||||
|
@cindex Block read/write
|
||||||
|
@cindex Port, block read/write
|
||||||
|
|
||||||
The Block-string-I/O module can be accessed with:
|
The Block-string-I/O module can be accessed with:
|
||||||
|
|
||||||
|
@ -618,6 +630,8 @@ return 0 immediately if the request size is 0 bytes.
|
||||||
|
|
||||||
@node Default Ports
|
@node Default Ports
|
||||||
@subsection Default Ports for Input, Output and Errors
|
@subsection Default Ports for Input, Output and Errors
|
||||||
|
@cindex Default ports
|
||||||
|
@cindex Port, default
|
||||||
|
|
||||||
@rnindex current-input-port
|
@rnindex current-input-port
|
||||||
@deffn {Scheme Procedure} current-input-port
|
@deffn {Scheme Procedure} current-input-port
|
||||||
|
@ -693,6 +707,8 @@ initialized with the @var{port} argument.
|
||||||
|
|
||||||
@node Port Types
|
@node Port Types
|
||||||
@subsection Types of Port
|
@subsection Types of Port
|
||||||
|
@cindex Types of ports
|
||||||
|
@cindex Port, types
|
||||||
|
|
||||||
[Types of port; how to make them.]
|
[Types of port; how to make them.]
|
||||||
|
|
||||||
|
@ -706,6 +722,8 @@ initialized with the @var{port} argument.
|
||||||
|
|
||||||
@node File Ports
|
@node File Ports
|
||||||
@subsubsection File Ports
|
@subsubsection File Ports
|
||||||
|
@cindex File port
|
||||||
|
@cindex Port, file
|
||||||
|
|
||||||
The following procedures are used to open file ports.
|
The following procedures are used to open file ports.
|
||||||
See also @ref{Ports and File Descriptors, open}, for an interface
|
See also @ref{Ports and File Descriptors, open}, for an interface
|
||||||
|
@ -866,6 +884,8 @@ Determine whether @var{obj} is a port that is related to a file.
|
||||||
|
|
||||||
@node String Ports
|
@node String Ports
|
||||||
@subsubsection String Ports
|
@subsubsection String Ports
|
||||||
|
@cindex String port
|
||||||
|
@cindex Port, string
|
||||||
|
|
||||||
The following allow string ports to be opened by analogy to R4R*
|
The following allow string ports to be opened by analogy to R4R*
|
||||||
file port facilities:
|
file port facilities:
|
||||||
|
@ -931,6 +951,8 @@ but trying to extract the file descriptor number will fail.
|
||||||
|
|
||||||
@node Soft Ports
|
@node Soft Ports
|
||||||
@subsubsection Soft Ports
|
@subsubsection Soft Ports
|
||||||
|
@cindex Soft port
|
||||||
|
@cindex Port, soft
|
||||||
|
|
||||||
A @dfn{soft-port} is a port based on a vector of procedures capable of
|
A @dfn{soft-port} is a port based on a vector of procedures capable of
|
||||||
accepting or delivering characters. It allows emulation of I/O ports.
|
accepting or delivering characters. It allows emulation of I/O ports.
|
||||||
|
@ -986,6 +1008,8 @@ For example:
|
||||||
|
|
||||||
@node Void Ports
|
@node Void Ports
|
||||||
@subsubsection Void Ports
|
@subsubsection Void Ports
|
||||||
|
@cindex Void port
|
||||||
|
@cindex Port, void
|
||||||
|
|
||||||
This kind of port causes any data to be discarded when written to, and
|
This kind of port causes any data to be discarded when written to, and
|
||||||
always returns the end-of-file object when read from.
|
always returns the end-of-file object when read from.
|
||||||
|
@ -1010,6 +1034,8 @@ documentation for @code{open-file} in @ref{File Ports}.
|
||||||
|
|
||||||
@node C Port Interface
|
@node C Port Interface
|
||||||
@subsubsection C Port Interface
|
@subsubsection C Port Interface
|
||||||
|
@cindex C port interface
|
||||||
|
@cindex Port, C interface
|
||||||
|
|
||||||
This section describes how to use Scheme ports from C.
|
This section describes how to use Scheme ports from C.
|
||||||
|
|
||||||
|
@ -1119,6 +1145,7 @@ is set.
|
||||||
|
|
||||||
@node Port Implementation
|
@node Port Implementation
|
||||||
@subsubsection Port Implementation
|
@subsubsection Port Implementation
|
||||||
|
@cindex Port implemenation
|
||||||
|
|
||||||
This section describes how to implement a new port type in C.
|
This section describes how to implement a new port type in C.
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue