Stream API Functions

This document lists most useful (and most often needed) functions. Be aware, that there are many more to be found in either the class references or via the builtin class browser.

Reference: Stream and ExternalStream and Socket

Back to Useful API Functions

Creation

Internal Streams

aCollection readStream => Stream
aString readStream => Stream

returns a stream to read from a general collection or especially from a string (which is a collection of characters)

aCollection writeStream
aString writeStream

returns a stream to write to a general collection or especially a string stream.

External Streams

pathString asFilename readStream => Stream
pathString asFilename writeStream => Stream
pathString asFilename appendingWriteStream => Stream

returns a stream to read / write the file named aFilenameString

Socket newTCPclientToHost:hostNameOrAddress port:aPortOrServiceName => SocketStream

returns a connected socket for reading and writing

Reading

next

Returns the next element from the stream.

aStream next

aStream.next() [JS]

Example:

 s := 'data.txt' asFilename readStream.
 s next.
 => character

next:

Returns the next n elements from the stream.

aStream next: count

aStream.next(count) [JS]

Example:

 s := 'data.txt' asFilename readStream.
 s next:5.
 => string-of-5-chars

nextByte

Returns the next character as a byte valued integer. Only valid for character streams.

nextBytes:

Returns the next n characters as a byteArray. Only valid for character streams.

Writing

nextPut:

Appends (writes) an element to the stream.

aStream nextPut: someElement

aStream.nextPut (someElement) [JS]

Example:

 s := 'data.txt' asFilename writeStream.
 s nextPut: $a.
 s nextPut: $b.
 s close.

Example:

 s := #() writeStream.
 s nextPut: 1.
 s nextPut: 'two'.
 s nextPut: 3.14159.
 s contents
 -> #( 1 'two' 3.14159 )

nextPutAll:

Appends (writes) a number of elements to the stream.

aStream nextPutAll: aCollectionOfElements

aStream.nextPutAll (aCollectionOfElements) [JS]

Example:

 s := 'data.txt' asFilename writeStream.
 s nextPutAll: 'abc'.
 s close.

nextPutByte:

Appends a byte valued integer to the stream. Only valid for character streams.

---

Copyright © 2014-2024 eXept Software AG