Next Previous Up Top Contents Index

5.11 The STREAMS module

read-through

Function

Summary

Returns a sequence containing the elements of the stream up to, and including, the first occurrence of a given element.

Signature

read-through input-stream element #key on-end-of-stream test 
=> sequence-or-eof found?

Arguments

input-stream
An instance of <stream>.

element
An instance of <object>.

on-end-of-stream
An instance of <object>.

test
An instance of <function>. Default value: ==.

Values

sequence-or-eof
An instance of <sequence>, or an instance of <object> if the end of the stream is reached.

found?
An instance of <boolean>.

Library

io

Module

streams

Description

This function is the same as read-to, except that element is included in the resulting sequence.

If the element is not found, the result does not contain it. The stream is left positioned after element.

See also

read-to, page 89


System and I/O Reference - 31 MAR 2000

Next Previous Up Top Contents Index