1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-29 19:30:36 +02:00

Document new interfaces

* NEWS: Update.
* doc/ref/api-io.texi (Bytevector Ports): Add docs.
This commit is contained in:
Andy Wingo 2021-01-12 12:24:59 +01:00
parent b2b1666d4c
commit 55ebf1b84a
2 changed files with 34 additions and 0 deletions

21
NEWS
View file

@ -4,6 +4,27 @@ See the end for copying conditions.
Please send Guile bug reports to bug-guile@gnu.org.
Changes in 3.0.6 (since 3.0.5)
* New interfaces and functionality
** `call-with-port'
See "Ports" in the manual.
** `call-with-input-bytevector', `call-with-output-bytevector'
See "Bytevector Ports" in the manual.
* Incompatible changes
** `call-with-output-string' closes port on normal exit
This procedure used to leave the port open, even though there was no
useful way to access it. Now we clean it up more promptly, disposing
any possible associated iconv descriptor.
Changes in 3.0.5 (since 3.0.4)

View file

@ -1166,6 +1166,19 @@ the data accumulated by the port, as illustrated below.
The @var{transcoder} argument is currently not supported.
@end deffn
@deffn {Scheme Procedure} call-with-output-bytevector proc
Call the one-argument procedure @var{proc} with a newly created
bytevector output port. When the function returns, the bytevector
composed of the characters written into the port is returned.
@var{proc} should not close the port.
@end deffn
@deffn {Scheme Procedure} call-with-input-bytevector bytevector proc
Call the one-argument procedure @var{proc} with a newly created input
port from which @var{bytevector}'s contents may be read. The values
yielded by the @var{proc} is returned.
@end deffn
@node String Ports
@subsubsection String Ports