Go to the first, previous, next, last section, table of contents.


readStreamPacket[

Function: readStreamPacket[ { noFragments stream -> [values] tag who }
file: job.t
package: muf
status: alpha

This is the fundamental non-root function for reading a message stream: It returns all information stored in the message stream for a particular packet, plus the value of @$s.actingUser in the job that sent the packet at the time the packet was sent, as an anti-spoofing measure. (see section |writeStreamPacket.)

One normally supplies t for noFragments, meaning that only completed packets should be read: Supplying nil for this parameter will result in even incomplete packets being returned, which is occasionally useful.

If no input is available, the job blocks until something arrives, unless both stream$s.dead and @$s.readNilFromDeadStreams are non-nil, in which case an empty block plus two nils are returned.

See section |readAnyStreamPacket.


Go to the first, previous, next, last section, table of contents.