Stream API Functions - Versionsgeschichte

Cg: /* Finish Writing */

2026-03-11T13:38:26Z

Finish Writing

← Nächstältere Version		Version vom 11. März 2026, 13:38 Uhr
Zeile 290:		Zeile 290:
	:''aStream'' '''contents''' => Collection		:''aStream'' '''contents''' => Collection
	::retrieves the elements written so far. For a string stream, that is the characters written so far as a string; for binary streams, that is the bytes written so far as a byte array; for other streams, that will be an Array containing the written objects.		::retrieves the elements written so far. For a string stream, that is the characters written so far as a string; for binary streams, that is the bytes written so far as a byte array; for other streams, that will be an Array containing the written objects.

			=== External Streams ===

			By default, external streams (i.e. FileStream, PipeStream, Socket, etc.) are in text mode. Reading will return characters or strings. The stream can be put into binary mode to get byte-sized integers or byte arrays. In addition, the end-of-line mode can be configured to one of CR, LF, CRLF or EOT.

Cg: /* Writing */

2026-03-11T13:34:37Z

Writing

← Nächstältere Version		Version vom 11. März 2026, 13:34 Uhr
Zeile 202:		Zeile 202:

	:''aStream'' '''cr'''		:''aStream'' '''cr'''
	::Appends (writes) a newline character (line-end character). Notice: although this function is named "cr", it actually writes a newline character (LF), which is the standard line-end convention used on Unix systems. The name "cr" is used for history reasons and for compatibility with other Smalltalk systems.		::Appends (writes) a newline character (line-end character). Notice: although this function is named "cr", it actually writes a newline character (LF), which is the standard line-end convention used on Unix systems. The name "cr" is used for history reasons and for compatibility with other Smalltalk systems.<br>For external streams, the end of line character can be changed to one of CR, LF, CRLF or EOT.
	:''aStream'' '''return'''		:''aStream'' '''return'''
	::Appends (writes) a return character. Use this, if you explicitly want a CR to be written.		::Appends (writes) a return character. Use this, if you explicitly want a CR to be written.

Cg: /* Writing */

2026-03-11T13:33:16Z

Writing

← Nächstältere Version		Version vom 11. März 2026, 13:33 Uhr
Zeile 247:		Zeile 247:
	:''aStream'' '''nextPutLine:''' ''aString''		:''aStream'' '''nextPutLine:''' ''aString''
	:''aStream'''''.nextPutLine(''' ''aString'' ''')''' [JS]		:''aStream'''''.nextPutLine(''' ''aString'' ''')''' [JS]
	::writes aString followed by a line end (which is a newline-character)		::writes aString followed by a line end (which is a newline-character by default, but can be changed for external streams)

Cg: /* Mode Settings */

2026-03-11T13:30:43Z

Mode Settings

← Nächstältere Version		Version vom 11. März 2026, 13:30 Uhr
Zeile 79:		Zeile 79:

	:''aStream'' '''buffered:''' ''aBoolean''		:''aStream'' '''buffered:''' ''aBoolean''
	:: for external write streams: turns buffering on/off.<br>By default, terminal stream are line buffered, while file streams use a larger buffer. When writing, buffers are filled first and then bigger chunks are written en-bloc. Notice that buffering may lead to characters written to a file a unseen by other programs until the buffer is flushed or the file stream is closed (see flush below).		:: for external write streams: turns buffering on/off.<br>By default, terminal stream are line buffered, while file streams use a larger buffer. When writing, buffers are filled first and then bigger chunks are written en-bloc. Notice that buffering may lead to characters written to a file being unseen by other programs until the buffer is flushed or the file stream is closed (see flush below).

	=== Reading ===		=== Reading ===

Cg: /* Mode Settings */

2026-03-11T13:27:37Z

Mode Settings

← Nächstältere Version		Version vom 11. März 2026, 13:27 Uhr
Zeile 70:		Zeile 70:
	===== Mode Settings =====		===== Mode Settings =====

	By default, character streams (in particular: file streams) are in text mode, meaning that the read functions retrieve characters or strings.<br>If the mode is switched to binary mode, bytes (integers) and byteArrays are retrieved.		By default, external character streams (in particular: file streams) are in text mode, meaning that the read functions retrieve characters or strings.<br>If the mode is switched to binary mode, bytes (integers) and byteArrays are retrieved.

	:''aStream'' '''binary'''		:''aStream'' '''binary'''
Zeile 80:		Zeile 80:
	:''aStream'' '''buffered:''' ''aBoolean''		:''aStream'' '''buffered:''' ''aBoolean''
	:: for external write streams: turns buffering on/off.<br>By default, terminal stream are line buffered, while file streams use a larger buffer. When writing, buffers are filled first and then bigger chunks are written en-bloc. Notice that buffering may lead to characters written to a file a unseen by other programs until the buffer is flushed or the file stream is closed (see flush below).		:: for external write streams: turns buffering on/off.<br>By default, terminal stream are line buffered, while file streams use a larger buffer. When writing, buffers are filled first and then bigger chunks are written en-bloc. Notice that buffering may lead to characters written to a file a unseen by other programs until the buffer is flushed or the file stream is closed (see flush below).


	=== Reading ===		=== Reading ===

Cg: /* Reading Words, Lines, etc. */

2026-03-11T13:24:03Z

Reading Words, Lines, etc.

← Nächstältere Version		Version vom 11. März 2026, 13:24 Uhr
Zeile 128:		Zeile 128:
	:: returns characters (in text mode) or bytes (in binary mode) up to ''element'' as either a string or byte array. The element itself will be read, but not be part of the returned collection (i.e. it is skipped over). This is useful e.g. to read characters up to a semicolon.		:: returns characters (in text mode) or bytes (in binary mode) up to ''element'' as either a string or byte array. The element itself will be read, but not be part of the returned collection (i.e. it is skipped over). This is useful e.g. to read characters up to a semicolon.

	:''aStream'' '''upToAny:''' ''~~collectionOfElement~~'' => String \| ByteArray		:''aStream'' '''upToAny:''' ''collectionOfElements'' => String \| ByteArray
	:: similar, but looks for multiple such separators. This is useful e.g. to read characters up to a either a semicolon or a comma (as in CSV files).		:: similar, but looks for multiple such separators. This is useful e.g. to read characters up to a either a semicolon or a comma (as in CSV files).

Cg: /* Binary Bytes */

2026-03-11T13:04:38Z

Binary Bytes

← Nächstältere Version		Version vom 11. März 2026, 13:04 Uhr
Zeile 109:		Zeile 109:

	:''aStream'' '''nextByte''' => Integer \| nil		:''aStream'' '''nextByte''' => Integer \| nil
	:: returns the next byte (as an integer), independent of the current read mode		:: returns the next byte (as an integer in [0..255]), independent of the current text/binary read mode

	:''aStream'' '''nextBytes:''' ''count'' => ByteArray		:''aStream'' '''nextBytes:''' ''count'' => ByteArray
	:: returns the next count bytes (as a byte array), independent of the read mode		:: returns the next count bytes (as a byte array), independent of the text/binary read mode
	<!--		<!--
	''aStream'' '''nextBytes:''' ''count'' '''into:''' ''aByteArray'' => count		''aStream'' '''nextBytes:''' ''count'' '''into:''' ''aByteArray'' => count
	:: reads the next count bytes into the given byteArray, independent of the read mode. Returns the number of bytes read (which might be less than count, if the End-Of-File is reached). Will report an error, if the given buffer is too small.		:: reads the next count bytes into the given byteArray, independent of the text/binary read mode. Returns the number of bytes read (which might be less than count, if the End-Of-File is reached). Will report an error, if the given buffer is too small.
	-->		-->
	:''aStream'' '''nextBytes:''' ''count'' '''into:''' ''aByteArray'' '''startingAt:''' ''index1Based'' => count		:''aStream'' '''nextBytes:''' ''count'' '''into:''' ''aByteArray'' '''startingAt:''' ''index1Based'' => count

Cg: /* External Streams */

2026-03-11T12:57:54Z

External Streams

← Nächstältere Version		Version vom 11. März 2026, 12:57 Uhr
Zeile 35:		Zeile 35:

	:Socket '''newTCPclientToHost:''' ''hostNameOrAddress'' '''port:''' ''aPortOrServiceName'' => SocketStream		:Socket '''newTCPclientToHost:''' ''hostNameOrAddress'' '''port:''' ''aPortOrServiceName'' => SocketStream
	:: returns a connected socket for reading and writing		:: returns a connected socket for reading and writing.<br>Browse the Socket class for many more socket creation operations.

	:PipeStream '''readingFrom:''' ''OS-command'' => PipeStream		:PipeStream '''readingFrom:''' ''OS-command'' => PipeStream

Cg: /* External Streams */

2026-03-11T12:56:18Z

External Streams

← Nächstältere Version		Version vom 11. März 2026, 12:56 Uhr
Zeile 44:		Zeile 44:
	:: returns a stream writing to the input of an operating system command		:: returns a stream writing to the input of an operating system command

	:PipeStream '''bidirectionalFor:''' ''OS-command'' => PipeStream		:PipeStream '''bidirectionalFor:''' ''OS-command'' => PipeStream (Unix/Linux only)
	:: returns a read/write stream to an operating system command. Writes will feed the program's input, whereas the program's output can be read from the pipe stream.		:: returns a read/write stream to an operating system command. Writes will feed the program's input, whereas the program's output can be read from the pipe stream.

Cg: /* External Streams */

2026-03-11T12:55:05Z

External Streams

← Nächstältere Version		Version vom 11. März 2026, 12:55 Uhr
Zeile 42:		Zeile 42:

	:PipeStream '''writingTo:''' ''OS-command'' => PipeStream		:PipeStream '''writingTo:''' ''OS-command'' => PipeStream
	:: returns a stream writing to the input of an operating system-command		:: returns a stream writing to the input of an operating system command

			:PipeStream '''bidirectionalFor:''' ''OS-command'' => PipeStream
			:: returns a read/write stream to an operating system command. Writes will feed the program's input, whereas the program's output can be read from the pipe stream.

	===== Wellknown Streams =====		===== Wellknown Streams =====